AI导哈

横向思维谜题服务

MCP服务器为横向思维谜题提供会话管理、问题解答和解决方案揭示功能。

  • by Yuikij
  • JavaScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 Yuikij/mcp-turtle-noir

使用说明

mcp黑色海龟

海龟汤（横向思维谜题）的MCP服务器。

此包是Turtle Noir后端API上的一个薄MCP层，专为 stdio 运输。

首页 | 中文文档 | 日本语

特性

  • start_session：开始一个新的谜题会话
  • ask_question：问一个问题，得到一个结构化的结果
  • give_up_and_reveal：显示解决方案（根据后端显示策略）
  • 多语言MCP输出(zh-CN, en-US, ja-JP)via language
  • 在正常游戏过程中，将谜题解决方案保留在后端

运输

  • 支持： 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 （可选不记名代币）

发展

npm install
npm run build
node dist/index.js

快速开始

看 QUICKSTART.md.

中文文档

看 README.zh-CN.md.

许可证

MIT。看 LICENSE.

致谢

相关 MCP