Skip to main content
Glama
endplay-dd-mcp-server

endplay-dd-mcp-server

by BSalita

endplay-dd-mcp-server

通过第一方 REST API 暴露 endplay 双明手计算的 MCP 服务器。MCP 进程是 HTTP 客户端,从不直接导入 Endplay。

工具

  • double_dummy(pbn: str)
    返回完整的 20 格赢墩表(N/E/S/W 庄家 × C/D/H/S/NT 花色)。

  • double_dummy_batch(pbns: list[str])
    在一次调用中为多副牌返回相同的结果结构。

Related MCP server: gambit

设置

cd c:/sw/bridge/ML-Contract-Bridge/src/endplay-dd-mcp-server
python -m venv .venv
.venv/Scripts/activate
pip install -e .

运行

先启动第一方 API,然后启动 MCP 客户端:

endplay-dd-api
# In another terminal:
endplay-dd-mcp

MCP 服务器默认通过 stdio 运行。使用 ENDPLAY_DD_API_BASE_URL 配置其 API 端点(默认 http://127.0.0.1:8001)。

示例输入

N:9642.95.AKQT4.K7 KJ3.K3.98.T98654 AQT85.Q862..AQJ2 7.AJT74.J76532.3

示例输出(结构)

{
  "ok": true,
  "pbn": "<input>",
  "table": {
    "denom_order": ["C", "D", "H", "S", "N"],
    "player_order": ["N", "E", "S", "W"],
    "by_declarer": {
      "N": {"C": 8, "D": 8, "H": 7, "S": 7, "N": 9},
      "E": {"C": 5, "D": 5, "H": 6, "S": 0, "N": 4},
      "S": {"C": 8, "D": 7, "H": 7, "S": 7, "N": 9},
      "W": {"C": 5, "D": 6, "H": 5, "S": 0, "N": 4}
    }
  }
}

Cursor MCP 配置示例

确保 endplay-dd-api 正在运行,然后在 MCP 配置中添加此服务器:

{
  "mcpServers": {
    "endplay-dd": {
      "command": "c:/sw/bridge/ML-Contract-Bridge/src/endplay-dd-mcp-server/.venv/Scripts/python.exe",
      "args": [
        "-m",
        "endplay_dd_mcp.server"
      ]
    }
  }
}

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables AI agents to analyze shogi (Japanese chess) positions and moves by integrating with USI protocol engines. Provides position analysis, move evaluation, and game state assessment through HTTP API bridge and MCP tools.
      3
      2
      MIT
    • A
      license
      C
      quality
      B
      maintenance
      Enables an AI host to perform bounded Stockfish engine analysis, whole-game review, opening-knowledge lookup, tactical puzzles, and persistent position-specific tutoring sessions. It also supports graduated hints, spaced review, speech plans, and optional local synthesis or board-screenshot recognition over stdio or HTTP transports.
      58
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI agents to join 250game-server rooms as ordinary players over native WebSocket without modifying the game server, supporting room setup, card play and manipulation, scoring, and turn-based decisions while filtering hidden information and rejecting stale-state actions.
      16
      MIT