Turtle Noir MCP

mcp-turtle-noir

Turtle Soup（水平思考パズル）用の MCP サーバーです。

このパッケージは Turtle Noir のバックエンド API を薄くラップした MCP レイヤーで、stdio トランスポート向けに設計されています。

ホームページ | 中文文档 | 日本語ドキュメント

機能

• start_session：新しいパズルセッションを開始します
• ask_question：質問を1つ行い、構造化された結果を受け取ります
• give_up_and_reveal：解答を表示します（バックエンドの公開ポリシーに従います）
• language による多言語 MCP 出力（zh-CN、en-US、ja-JP）
• 通常のゲームプレイ中、パズルの解答はバックエンドに保持されます

トランスポート

• 対応：stdio
• このパッケージには含まれません：SSE/HTTP MCP トランスポート

要件

• Node.js 18+

インストールと実行

npx -y mcp-turtle-noir

MCP クライアント設定

{
  "mcpServers": {
    "turtle-noir": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-turtle-noir"
      ]
    }
  }
}

環境変数を使用する場合：

{
  "mcpServers": {
    "turtle-noir": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-turtle-noir"
      ],
      "env": {
        "TURTLE_NOIR_API_BASE_URL": "https://turtlenoir.com/api/mcp",
        "TURTLE_NOIR_API_TIMEOUT_MS": "10000",
        "TURTLE_NOIR_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

ツール

1) start_session

入力（すべて任意）：

{
  "region": "US",
  "keyword": "island",
  "language": "en-US"
}

出力：

{
  "session_id": "...",
  "puzzle_id": "...",
  "title": "...",
  "content": "...",
  "language": "en-US",
  "instruction": "...",
  "translation_instruction": "..."
}

2) ask_question

入力：

{
  "session_id": "...",
  "question": "...",
  "language": "en-US"
}

出力：

{
  "session_id": "...",
  "language": "en-US",
  "answer_key": "irrelevant",
  "answer": "Irrelevant",
  "answer_original": "...",
  "short_reason": "...",
  "solved": false,
  "progress": 35,
  "translation_instruction": "..."
}

3) give_up_and_reveal

入力：

{
  "session_id": "...",
  "language": "en-US"
}

出力：

{
  "session_id": "...",
  "language": "en-US",
  "title": "...",
  "solution": "...",
  "cta_url": "https://turtlenoir.com",
  "cta_text": "...",
  "translation_instruction": "..."
}

注：進行度がしきい値を下回る場合（例：progress < 60）、バックエンドが解答の公開を拒否することがあります。

環境変数

• TURTLE_NOIR_API_BASE_URL（デフォルト：https://turtlenoir.com/api/mcp）
• TURTLE_NOIR_API_TIMEOUT_MS（デフォルト：10000）
• TURTLE_NOIR_API_KEY（任意の Bearer トークン）

開発

npm install
npm run build
node dist/index.js

クイックスタート

QUICKSTART.md を参照してください。

中国語ドキュメント

README.zh-CN.md を参照してください。

ライセンス

MIT。LICENSE を参照してください。

謝辞

• 公式ウェブサイト：Turtle Noir
• 中国語ミラーサイト：出前一汤