MCP Retroachievements

复古成就MCP（黑曜石金库项目）

MCP服务器，用于查询RetroAchievements。

C#替代服务器存在 ./csharp 并且现在是优选的实施方式。 TypeScript的实现 ./src 为了迁移兼容性而暂时保留。

功能（MVP）

• ra_search_games
• ra_get_game
• ra_get_game_achievements
• ra_get_user_recently_played
• ra_get_user_progress
• ra_sync_game
• ra_sync_user

设置

1. 安装deps

- npm install

1. 创建环境

- cp .env.example .env - 填充 RA_USERNAME 和 RA_API_KEY

1. 构建

- npm run build

1. 运行（stdio MCP）

- npm start

在临床MCP设置中配置

添加 /home/lancer1977/.cline/data/settings/cline_mcp_settings.json:

{
  "mcpServers": {
    "retroachievements": {
      "command": "node",
      "args": [
        "/home/lancer1977/vaults/work/30_Creation/Projects/RetroAchievements MCP/dist/index.js"
      ],
      "env": {
        "RA_USERNAME": "your_username",
        "RA_API_KEY": "your_api_key",
        "RA_BASE_URL": "https://retroachievements.org/API",
        "CACHE_DB_PATH": "/home/lancer1977/vaults/work/30_Creation/Projects/RetroAchievements MCP/data/retroachievements.sqlite"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

备注

• SQLite缓存文件默认为 data/retroachievements.sqlite.
• ra_sync_* 工具强制从远程API刷新并更新缓存。
• 端点假设和验证说明见 docs/retroachievements-api-notes.md.