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 分