The Nothing

The Nothing

又称 Mr. Decoupler —— 一个故意什么也不做的 MCP 服务。

有时，少即是多。

---

这个理念：有时，少即是多

大多数 MCP 服务都在竞相做 更多：连接更多数据库、读取更多文件、调用更多 API。需要这些功能时当然很好。但很多简单场景其实并不需要，而每增加一个连接，就多一个需要管理的凭据、多一件可能出故障的事，也多一种 AI 接触不该访问的数据的方式。

The Nothing 采取了截然相反的做法。它不连接任何数据库，不读取任何数据集，不发起任何网络调用，不向磁盘写入任何内容，也不会在调用之间记住任何信息。它 真正 提供的是一个简洁、稳定的连接界面——一份 AI 可以交互的工具契约——让 AI 永远不会直接连接到你的数据层。

这就是我们称它为 Mr. Decoupler 的原因。他礼貌地站在 AI 和数据之间，原样返回收到的内容，至于之后（或永远不）在他背后接入什么，则由你决定。

为什么要使用一个什么也不做的服务？

使用场景	Mr. Decoupler 的作用
在数据库建成前为 AI 工作流制作原型	现在就用 pass_through 设计提示词和 Agent 流程；之后接入真正的数据服务，无需改变 AI 所看到的内容。
让 AI 远离生产数据	为 Agent 提供一个数据形式的工具，但它在物理层面上无法读取、写入或删除任何内容。
演示、研讨会和 MCP 教学	尽可能精简的可运行 MCP 服务：包含工具、资源和提示词，无需任何设置。
测试 MCP 客户端和宿主	一个可预测、确定性的服务，用于检查客户端是否能够连接、列出工具并处理结果。
对数据操作进行试运行	让 AI 描述它 打算 执行的 operation 和 payload；在实际执行任何操作前进行审核。
在多服务配置中使用占位项	为未来的数据源预留位置，这样之后就不必修改配置、文档和提示词。
明确选择“无需操作”	有时，对于“我应该查询数据库吗？”这个问题，正确答案就是“不”。nothing 能将这一点明确表达出来。

包含内容

类型	名称	行为
工具	nothing	接受任何内容，并返回 ...。无副作用。
工具	pass_through	原样返回收到的 payload（恒等操作）。可选的 operation 标签会被记录，但不会执行。
工具	search	始终返回 {"results": []}。
工具	fetch	对任何 id 都返回空文档。
资源	nothing://void	内容为 ...。
提示词	less-is-more	提醒模型检查不采取任何操作是否已经足够。

所有工具都标注为只读、幂等、非破坏性且封闭世界，因此遵循 MCP 工具注释的客户端无需确认提示即可运行这些工具。提供 search 和 fetch 是为了兼容 ChatGPT 连接器等面向搜索的客户端；它们按设计什么也找不到。

安装

唯一的要求是 Node.js 18+。

npx -y the-nothing-mcp           # stdio (local clients)
npx -y the-nothing-mcp --http    # Streamable HTTP at http://0.0.0.0:3000/mcp (remote clients)

可选参数：--port 3000、--host 0.0.0.0，或环境变量 THE_NOTHING_TRANSPORT=http、PORT、HOST。

将它连接到你的 AI

本地客户端（stdio）

大多数本地客户端使用相同的 mcpServers 配置块：

{
  "mcpServers": {
    "the-nothing": {
      "command": "npx",
      "args": ["-y", "the-nothing-mcp"]
    }
  }
}

客户端	配置位置
Claude Desktop	设置 → Developer → Edit Config（claude_desktop_config.json）
Claude Code	claude mcp add the-nothing -- npx -y the-nothing-mcp
Cursor	~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目）
Windsurf	~/.codeium/windsurf/mcp_config.json
Gemini CLI	~/.gemini/settings.json，或 gemini mcp add the-nothing npx -y the-nothing-mcp
Cline / Roo Code / Kilo Code	MCP Servers → Configure → cline_mcp_settings.json
Zed	settings.json 中的 context_servers 配置项
JetBrains AI Assistant / Junie	设置 → Tools → AI Assistant → MCP → Add → 粘贴 JSON
Continue、LM Studio、Goose 等	在它们的 MCP 设置中配置；命令和参数相同

VS Code + GitHub Copilot — 从 Marketplace 安装 The Nothing 扩展（无需配置），或添加 .vscode/mcp.json：

{
  "servers": {
    "the-nothing": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "the-nothing-mcp"]
    }
  }
}

OpenAI Codex CLI — ~/.codex/config.toml：

[mcp_servers.the-nothing]
command = "npx"
args = ["-y", "the-nothing-mcp"]

远程客户端（Streamable HTTP）

ChatGPT、Grok、claude.ai 自定义连接器和托管 Agent API 通过 HTTPS 访问 MCP 服务，因此请在可公开访问的位置以 HTTP 模式运行 The Nothing：

npx -y the-nothing-mcp --http --port 3000
# or
docker build -t the-nothing . && docker run -p 3000:3000 the-nothing

将其置于 HTTPS 后面（可使用任意主机，也可使用 Cloudflare Tunnel 或 ngrok 等隧道进行测试），然后使用 https://your-host/mcp：

客户端	方法
ChatGPT	设置 → Apps & Connectors → 启用 Developer mode → Create → MCP server URL
Claude（claude.ai / Desktop / mobile）	设置 → Connectors → Add custom connector → URL
Grok（xAI API）	添加远程 MCP 工具，并将 server_url 指向你的 /mcp 端点
Gemini API / Google ADK	使用 SDK 的 MCP 客户端和 Streamable HTTP 传输方式
OpenAI Responses / Agents SDK	添加 mcp 工具，并设置 server_url

HTTP 服务是无状态的（没有会话、没有身份验证、不存储任何内容），可响应 GET /health，并发送宽松的 CORS 标头。它不需要任何密钥，因为没有需要保护的内容。

将其用作库

import { createServer } from "the-nothing-mcp";
const server = createServer(); // a fresh McpServer that does nothing

开发

npm install
npm test               # exercises every tool over stdio and HTTP
npm run build:vscode   # bundles the server into the VS Code extension

有关如何发布到 npm、官方 MCP Registry 和 VS Code Marketplace，请参阅 PUBLISHING.md。

常见问题

它真的什么都不做吗？ 是的。请阅读 src/server.js；代码很简短。除了 MCP 传输本身，不会进行任何 I/O 操作。

那为什么不干脆不运行服务？ 因为稳定的契约有其价值。The Nothing 让你的 AI、提示词和配置依赖接口，而非具体实现。准备好接入真实数据时，只需将 Mr. Decoupler 替换为一个提供相同工具的服务，其他一切都无需更改。

把它交给自主 Agent 安全吗？ 这几乎是软件所能达到的最高安全级别：它无法访问任何内容。

许可证

MIT

mcp-name: io.github.Meador793/the-nothing

...