关于 Turtle Noir MCP
Turtle Noir MCP 是用于 Turtle Soup 横向思维谜题的 MCP 服务,适合通过提问逐步推理谜底的玩家。它支持多语言输出,并在正常游戏过程中将谜底保留在后端。
主要功能
- 01开启新的谜题会话
- 02提问并获取结构化判定
- 03按规则揭示谜底
- 04支持中英日输出
- 05游戏期间谜底留在后端
适用场景
- 01开始一局横向思维谜题
- 02根据回答逐步缩小谜题范围
- 03符合条件时查看谜底
- 04以不同语言进行游戏
MCP 相关
该服务通过 stdio 传输向 MCP 客户端提供开始会话、提问和揭示谜底等工具;不包含 SSE/HTTP 传输。
配置
远程服务无需本地安装。选择你使用的客户端,复制配置或使用一键安装。
服务地址
https://turtlenoir.com/mcp一键复制安装命令
Claude CodeTerminal
claude mcp add --transport http yuikij-mcp-turtle-noir https://turtlenoir.com/mcpCursor.cursor/mcp.json
{"mcpServers":{"yuikij-mcp-turtle-noir":{"type":"http","url":"https://turtlenoir.com/mcp"}}}在 Cursor 中打开VS Code.vscode/mcp.json
{"servers":{"yuikij-mcp-turtle-noir":{"type":"http","url":"https://turtlenoir.com/mcp"}}}在 VS Code 中打开Claude Desktopclaude_desktop_config.json
{"mcpServers":{"yuikij-mcp-turtle-noir":{"type":"http","url":"https://turtlenoir.com/mcp"}}}Windsurf~/.codeium/windsurf/mcp_config.json
{"mcpServers":{"yuikij-mcp-turtle-noir":{"serverUrl":"https://turtlenoir.com/mcp"}}}命令在终端中运行;JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
工具
3| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| region | string | 否 | 可选地区代码,例如 US/CN/JP |
| difficulty | enum | 否 | 可选难度偏好简单 | 中等 | 困难 |
| keyword | string | 否 | 标题/表面/标签上的可选模糊关键词 |
| language | string | 否 | 用于本地化响应的用户语言,例如 zh-CN/en-US/ja-JP |
详细介绍
mcp-turtle-noir
Turtle Soup(海龟汤横向思维谜题)的 MCP 服务。
此软件包是 Turtle Noir 后端 API 的轻量 MCP 层,专为 stdio 传输设计。
功能
start_session:开始新的谜题会话ask_question:提问并接收结构化结果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
- 中文镜像:出前一汤
评论
支持 Markdown
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。