modrinth-mcp

Modrinth API를 감싸는 MCP 서버로, AI 에이전트(Claude Code, Claude Desktop, Cursor 등)가 프로젝트를 검색하고, 프로젝트/버전 메타데이터를 읽고, Minecraft 모드를 게시할 수 있게 해줍니다 — 프로젝트를 생성하고 빌드된 jar를 새 버전으로 업로드합니다.

도구

읽기 전용 도구는 토큰 없이 작동합니다. 쓰기 작업에는 Modrinth 개인 액세스 토큰이 필요합니다.

Related MCP server: ModWrench MCP Server

토큰 받기

https://modrinth.com/settings/pats에서 다음 범위로 PAT를 생성하세요:

• 프로젝트 읽기

• 버전 읽기

• 버전 생성

• 버전 쓰기

MODRINTH_TOKEN 환경 변수로 설정하세요.

설치

Claude Code 플러그인으로

/plugin marketplace add justinscott12/modrinth-mcp
/plugin install modrinth-mcp@justinscott12

플러그인을 활성화할 때 Modrinth 토큰을 입력하라는 메시지가 표시됩니다. 내부적으로 npx를 통해 게시된 npm 패키지를 실행합니다.

MCP 서버로 (모든 클라이언트)

MCP 클라이언트 구성에 추가하세요 (예: Claude Desktop claude_desktop_config.json):

{
  "mcpServers": {
    "modrinth": {
      "command": "npx",
      "args": ["-y", "@justinscott12/modrinth-mcp"],
      "env": {
        "MODRINTH_TOKEN": "your-modrinth-pat"
      }
    }
  }
}

또는 Claude Code에서 직접:

claude mcp add modrinth --env MODRINTH_TOKEN=your-modrinth-pat -- npx -y @justinscott12/modrinth-mcp

환경 변수

예시 흐름

1. modrinth_whoami — 인증이 작동하는지 확인합니다.

2. modrinth_create_project — 프로젝트 페이지를 생성합니다(초안으로 생성됨).

3. modrinth_create_version — 대상 game_versions 및 loaders로 빌드된 jar를 업로드합니다.

4. 준비가 되면 Modrinth 사이트에서 프로젝트를 검토용으로 제출합니다.

참고: create_version 및 create_project는 공개 콘텐츠를 게시합니다. 실제로 게시하려는 경우에만 호출하세요.

개발

npm install
MODRINTH_STAGING=1 MODRINTH_TOKEN=your-staging-pat npm start

서버는 stdio를 통해 MCP를 사용합니다. stdout은 프로토콜 전용이며, 로그는 stderr로 출력됩니다.

라이선스

MIT