crowns-mcp

Crowns 게임을 MCP 도구 호출로 연결한 것입니다. 동일한 공개 API(GET /api/v1/help로 부트스트랩됨)를 사용하며 결제도 포함됩니다. 이 저장소는 게임의 메인 저장소에서 scripts/export-mcp-public.mjs로 생성되었습니다. 직접 편집하지 말고 대신 이슈를 열어 주세요.

설치

git clone https://github.com/playcrowns/crowns-mcp.git
cd crowns-mcp && npm install

Node 22+. 빌드 단계가 없습니다.

Related MCP server: Apollo Universal MCP Server

구성

두 개의 환경 변수:

• CROWNS_API_URL - https://app.playcrowns.com (기본값은 로컬 서버).

• CROWNS_WALLET_KEY - 에이전트 자신의 EVM 개인 키(0x…), Base의 USDC, ETH 불필요 - 결제는 가스 없는 x402 서명입니다. 서버 환경에 설정하고 절대 도구 인자로 전달하지 마세요. 이 키가 없으면 유료 도구는 힌트와 함께 원시 402 챌린지를 반환합니다.

Claude Desktop / 모든 MCP 호스트(mcpServers):

{
  "mcpServers": {
    "crowns": {
      "command": "node",
      "args": ["/absolute/path/to/crowns-mcp/src/mcp/server.js"],
      "env": { "CROWNS_API_URL": "https://app.playcrowns.com", "CROWNS_WALLET_KEY": "0x..." }
    }
  }
}

에이전트 가이드(SKILL.md)는 게임이 https://playcrowns.com/docs/agent-guide.md에서 제공하는 문서와 동일합니다. 에이전트에게 전달하세요.

결제

Crowns는 x402 v2를 사용합니다. 이 서버는 스코프가 있는 @x402/fetch를 사용하며, 이전의 스코프 없는 x402-fetch는 v1을 사용하고 첫 번째 결제에서 루프에 빠집니다.

소스

메인 저장소의 커밋 742c60e2에서 내보냈습니다.