trackmcp
Back to directory
Yuikij

mcp-turtle-noir

View on GitHub

Turtle Noir

1 stars JavaScriptOthers Updated Jul 21, 2026

Documentation

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 install
npm run build
node dist/index.js

Quick Start

See `QUICKSTART.md`.

Chinese Docs

See `README.zh-CN.md`.

License

MIT. See `LICENSE`.

Acknowledgements

Frequently asked questions

What is mcp-turtle-noir?

mcp-turtle-noir is Turtle Noir

How do I install mcp-turtle-noir?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is mcp-turtle-noir open source?

Yes — it is hosted on GitHub at https://github.com/Yuikij/mcp-turtle-noir and has 1 stars.

Related MCP tools

firecrawlfirecrawl-mcp-server

🔥 Official Firecrawl MCP Server - Adds powerful web scraping and search to Cursor, Claude and any other LLM clients.

7,393 JavaScript
batch-processingclaudecontent-extraction+11
u14appdeep-research

Use any LLMs (Large Language Models) for Deep Research. Support SSE API and MCP server.

4,684 JavaScript
deep-researchdeepresearchgemini+7
Minidoracatmcp-feedback-enhanced

Enhanced MCP server for interactive user feedback and command execution in AI-assisted development, featuring dual interface support (Web UI and Desktop Application) with intelligent environment detection and cross-platform compatibility.

3,773 JavaScript
papersgptpapersgpt-for-zotero

A powerful Zotero AI and MCP plugin with ChatGPT, Gemini 3.7, Claude Fable 5, Claude Opus 5, DeepSeek V4, Grok, OpenRouter, Kimi k3, GLM 5.3, SiliconFlow, GPT-oss, Gemma 4, Qwen 3.8

2,625 JavaScript
zoteromistralclaude+17
aeonfunopendia

Connect your browser to AI models. Just use Dia on Chrome, Arc or Firefox.

1,920 JavaScript
chrome-extensiondiamcp+3
caol64wenyan-mcp

文颜 MCP Server 可以让 AI 自动将 Markdown 文章排版后发布至微信公众号。

1,310 JavaScript
mcp-serverwenyanwechat

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP