MCP ArkhamDB服务器
用于与ArkhamDB公共API交互的MCP（模型上下文协议）服务器。该服务器提供工具，用于查询《阿卡姆恐怖：纸牌游戏》中的纸牌和套牌。
特性
- 获取卡片：通过特定卡的代码检索其详细信息
- 按名称搜索卡片：按名称搜索卡片（不区分大小写的部分匹配）
- 寻找卡片协同效应：基于文本分析、特征匹配和机械关键字，发现与给定卡片协同的卡片
- 获取甲板：通过ID检索甲板（可能需要身份验证）
- 获取甲板清单：按ID检索甲板清单
- 建议甲板改进：考虑到调查员的要求（牌组大小、班级限制、级别、经验），建议可以改善牌组的卡片
使用MCP服务器的提示示例
西班牙语
Utiliza el mcp de arkhamdb para bajar información sobre el siguiente mazo: 5570650
Quiero que analices todas sus cartas, sus sinergias, y me expliques sus puntos fuertes y sus debilidades, y cómo utilizarlo y jugar este mazo, incluyendo información sobre qué mulligan debería hacer. Puedes buscar en internet información sobre Arkham Horror LCG. Los nombres de las cartas y la explicación han de estar en español.Sugiéreme mejoras para este mazo 5570650 usando el mcp de arkhamdb, recuerda poner los nombres de las cartas en español, recuerda que el mazo no puede tener más de 30 cartas (sin contar las propias de darrell), por lo que no se puede añadir cartas y ya está, hay que quitar otras. Hay muchas más cartas en el mazo, intenta enfocarte en cartas que aprovechen sinergias con "evidence", con añadir pruebas y usar pruebas con la habilidad de darrell, y también con cartas para descubrir más pistas结果： 示例/darrell-改进.md
Usa el MCP de arkhamdb para encontrar sinergias para Darrell Simmons, que usa `evidence`, recuerda usar el nombre español de las cartasAyúdame a montar un mazo de Trish Scarborough para jugar la campaña de Innsmouth. Puedes buscar información sobre mazos en internet y usar las herramientas del MCP de arkhamdb. He visto dos posibles mazos iniciales, aunque no me gusta lo de empezar con "En la brecha". https://es.arkhamdb.com/deck/view/2635733 https://es.arkhamdb.com/decklist/view/26638/trish-scarborough-starter-deck-1.0结果（经过一些迭代）： 示例/三氢碳纤维厚度.md
用英语
Use the arkhamdb mcp to get information about the following deck: 5570650
I want you to analyze all its cards, its synergies, and explain its strengths and weaknesses, and how to use it and play this deck, including information about what mulligan should be made. You can search the internet for information about Arkham Horror LCG.安装
- 克隆此存储库
- 安装依赖项：
make dependencies或手动：
go mod download- 构建服务器：
make build或手动：
go build -o arkhamdb-mcp使用Docker运行
- 构建并启动服务器：
docker-compose up --build- 服务器将使用MCP协议监听stdin/stdout。
对于Cursor集成，您可以使用 run-docker-mcp.sh 脚本：
{
"mcpServers": {
"arkhamdb": {
"command": "
/arkhamdb-mcp/run-docker-mcp.sh",
"args": []
}
}
}用法
服务器使用MCP协议通过stdin/stdout进行通信。它连接到ArkhamDB API https://es.arkhamdb.com.
测试
使用提供的测试脚本：
./test-mcp.sh或者通过stdin使用JSON-RPC进行手动测试：
初始化服务器：
echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test-client","version":"1.0.0"}}}' | ./arkhamdb-mcp列出可用工具：
echo -e '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test-client","version":"1.0.0"}}}\n{"jsonrpc":"2.0","id":2,"method":"tools/list"}' | ./arkhamdb-mcp获取一张卡片：
echo -e '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test-client","version":"1.0.0"}}}\n{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"arkhamdb_get_card","arguments":{"cardCode":"01001"}}}' | ./arkhamdb-mcp按名称搜索卡片：
echo -e '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test-client","version":"1.0.0"}}}\n{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"arkhamdb_search_cards_by_name","arguments":{"name":"Roland"}}}' | ./arkhamdb-mcp拿一个甲板：
echo -e '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test-client","version":"1.0.0"}}}\n{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"arkhamdb_get_deck","arguments":{"deckID":12345}}}' | ./arkhamdb-mcp寻找卡片协同效应：
echo -e '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test-client","version":"1.0.0"}}}\n{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"arkhamdb_find_card_synergies","arguments":{"cardCode":"06332","maxResults":10}}}' | ./arkhamdb-mcp协同查找器使用多种方法分析卡片：
- 特性参考：查找与显式特征引用匹配的卡片（例如。，
[[Item]],[[Spell]]) - 共享特征：识别具有匹配特征的卡片
- 机械关键词：检测与类似游戏机制（调查、伤害、资源等）交互的卡牌
- 插槽兼容性：考虑设备插槽兼容性
建议甲板改进：
echo -e '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test-client","version":"1.0.0"}}}\n{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"arkhamdb_suggest_deck_improvements","arguments":{"decklistID":5570650,"maxResults":20}}}' | ./arkhamdb-mcp牌组改进工具分析牌组，并建议可以改进它的牌组：
- 调查员要求：尊重甲板尺寸、等级限制（派系）、级别限制和经验要求
- 协同效应分析：根据与现有牌组的协同作用对牌进行评分
- 甲板兼容性：仅建议调查员使用合法的卡片
- 优先级排序：喜欢低成本和0级卡，以便更容易纳入
与AI模型集成
此MCP服务器可以与以下设备集成：
- 光标
- 克劳德桌面
- 支持MCP的ChatGPT
- 任何兼容MCP的AI客户端
配置您的AI客户端，使其通过stdio使用MCP协议连接到此服务器。对于Cursor，添加到您的 mcp.json:
{
"mcpServers": {
"arkhamdb": {
"command": "
/arkhamdb-mcp/arkhamdb-mcp",
"args": []
}
}
}api参考
服务器使用公共ArkhamDB API端点：
GET /api/public/card/{card_code}.json-获得一张卡GET /api/public/cards/-获取所有卡片（用于按名称搜索和协同检测）GET /api/public/deck/{deck_id}.json-获取一副牌（可能需要身份验证）GET /api/public/decklist/{decklist_id}.json-获取甲板清单
协同发现工具(arkhamdb_find_card_synergies)使用卡片端点来分析所有卡片，并通过文本解析和特征匹配来识别协同作用。
有关更多信息，请参阅 ArkhamDB API文件.
发展
代码质量
- 棉绒：运行
make lint检查代码质量 - 格式：运行
make format格式化代码 - 检查：运行
make inspect检查MCP协议合规性
生成文件目标
make dependencies-安装所有依赖项make lint-运行门楣make format-格式代码make inspect-检查MCP协议合规性make build-构建Docker镜像
建筑
服务器采用模块化架构：
main.go-入口点和初始化server/-MCP协议实现tools/-工具接口定义arkhamdb/-ArkhamDB API客户端实现
- arkhamdb.go -API客户端和卡/套取 - synergy.go -协同检测逻辑（文本解析、特征匹配、评分）
许可证
MIT许可证