Mcp Turtle Noir

io.github.Yuikij由 GitHub 账号 Yuikij 发布v1.3.0更新于 Oct 24, 2026

Play Turtle Soup (lateral thinking puzzles) against a strict AI host with yes/no questioning.

已验证Streamable HTTP可网页运行

概览

AI 生成的概览

让助手与严格的 AI 主持人玩海龟汤(横向思维谜题),通过是非提问推进并查看解题进度。

可以做什么
  • 开启谜题会话,可按地区、难度或关键词筛选,获得谜面,而谜底保留在服务器端。
  • 每次提出一个是非型问题,得到结构化判定(是、不是、是也不是、没有关系)、简短理由以及 0 到 100 的解题进度。
  • 在符合后端揭示规则的前提下揭晓隐藏谜底并结束会话。
  • 通过 language 参数获取中文、英文或日文输出。
适用场景
适合让助手主持或参与横向思维猜谜游戏,需要结构化回答和进度反馈,而不是自由发挥的角色扮演。
运行要求
通过 npx 以 stdio 方式在本地运行,需要 Node.js 18 或更高版本,也可使用远程端点。可选环境变量用于设置后端 API 地址、请求超时和 API 密钥。
安装前请注意
可选的 API 密钥以 Bearer 令牌形式放在环境变量中,避免写入共享配置。提问与会话数据会发送到 Turtle Noir 后端。进度未达阈值时无法揭晓,揭晓结果中可能带有推广链接。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Mcp Turtle Noir,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable,通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体,或 SourceWeft 对话中。智能体会读取该服务器的安装指南,先向你展示发布者、端点和登录方式,经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.Yuikij%2Fmcp-turtle-noir/install.md,并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前,先告诉我它的发布者、端点和登录方式,等我确认。不要把 API 密钥写进命令或我会提交的文件;问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "turtle-noir": {
      "type": "http",
      "url": "https://turtlenoir.com/mcp"
    }
  }
}

README

mcp-turtle-noir

MCP server for Turtle Soup (lateral thinking puzzles).

This package is a thin MCP layer over Turtle Noir backend APIs and is designed for stdio transport.

Homepage | 中文文档 | 日本語

Features

  • start_session: start a new puzzle session
  • ask_question: ask one question and receive a structured result
  • give_up_and_reveal: reveal the solution (subject to backend reveal policy)
  • Multilingual MCP output (zh-CN, en-US, ja-JP) via language
  • Keeps puzzle solutions on the backend during normal gameplay

Transport

  • Supported: stdio
  • Not included in this package: SSE/HTTP MCP transport

Requirements

  • Node.js 18+

Install and Run

bash
npx -y mcp-turtle-noir

MCP Client Config

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

With environment variables:

json
{  "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"      }    }  }}

Tools

1) start_session

Input (all optional):

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

Output:

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

2) ask_question

Input:

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

Output:

json
{  "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

Input:

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

Output:

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

Note: backend may reject reveal if progress is below a threshold (for example progress < 60).

Environment Variables

  • TURTLE_NOIR_API_BASE_URL (default: https://turtlenoir.com/api/mcp)
  • TURTLE_NOIR_API_TIMEOUT_MS (default: 10000)
  • TURTLE_NOIR_API_KEY (optional Bearer token)

Development

bash
npm installnpm run buildnode dist/index.js

Quick Start

See QUICKSTART.md.

Chinese Docs

See README.zh-CN.md.

License

MIT. See LICENSE.

Acknowledgements

来源:README.md,提交 a3b77f4

工具

3

start_session

Start a Turtle Soup puzzle session

Start a new Turtle Soup (lateral thinking puzzle) session. Returns the surface story; the hidden solution stays on the server. Optional filters: region (CN/US/JP), difficulty, keyword.

输入参数regionkeyworddifficulty

ask_question

Ask the AI host a question

Ask one yes/no style question about the current puzzle. The AI host answers with one of four judgments: 是(Yes) / 不是(No) / 是也不是(Both) / 没有关系(Irrelevant), plus solve progress (0-100).

输入参数question必填session_id必填

give_up_and_reveal

Give up and reveal the solution

Reveal the hidden solution and end the session. Only allowed once solve progress reaches 60.

输入参数session_id必填

版本历史

1
  1. v1.3.0最新Sep 16, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分