Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

feature: an MCP server and a CLI over data.json so agents and scripts can query licensed assets directly

Open
#115 0 comments 0 reactions 0 assignees View on GitHub

Maintainers usually reply within 1 day

Nobody has claimed this yet.

Assessment

Difficulty
5/5
Estimated time
Over a week
Newbie friendliness
30/100
Issue type
Feature
Clarity
Clearly specified
Activity status
Active
Tech stack
javascript, node.js

Research direction

Start with site/README.md for the documented data fields and site/lib/search.mjs for the existing Node search and filter logic. Then inspect site/dist/data.json to understand the catalog records. Done means a CLI can search from npx, an MCP server exposes the requested tools in at least one client, and the README links both.

Written by the indexing model from the issue text.

Description

feature priority: medium

Why it matters
The repo already ships llms.txt and llms-full.txt, so the audience includes people asking an assistant "find me a CC0 pixel font" or "is this pack OK in a commercial Unreal game". A Model Context Protocol server turns the catalog into a tool those assistants call with structured filters (category, licence family, commercial, attribution, engine lock, format) and get back the recorded licence text and verified date instead of a guess. A CLI gives shell users and CI jobs the same (for example, fail a build if a referenced asset is commercial: false). Both are thin wrappers over data.json.

Evidence

  • site/dist/data.json with stable, documented fields (site/README.md).
  • site/lib/search.mjs already holds scoring and filter logic that runs in Node unchanged.

Suggested approach

  1. A package (separate repo or packages/mcp/) with tools search_assets, get_asset, check_license(id, engine, commercial), list_stacks; fetches data.json from the Pages URL with a cache and a --data flag for local builds.
  2. Publish to npm with a bin: npx free-game-dev-assets search "pixel font" --license cc0 --format ttf.
  3. README section "Use the data" with Claude Desktop / Cursor config snippets.

Done when
The CLI search works from npx, the MCP server appears in at least one client with its tools, and the README links both.

Dominant language
JavaScript
Stars
58
Forks
15
Avg merge
16h 53m
Merged PRs (30d)
14

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from TMHSDigital/Free-Game-Dev-Assets

All issues in TMHSDigital/Free-Game-Dev-Assets

Similar issues

More JavaScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.