EmDash Docs MCP

本页内容

EmDash 文档站点在 https://docs.emdashcms.com/mcp 提供了一个 Model Context Protocol 服务器。将您的编码助手连接到它,助手就可以在您工作时搜索文档,而不是从可能过时的训练数据中猜测。

这与您网站的 MCP 服务器是分开的(在 AI 工具指南中介绍)。文档 MCP 只了解 EmDash 的文档——它无法读取或修改您的内容。大多数开发者想要两者:用于查找信息的文档 MCP,以及用于管理内容的网站 MCP。

它的功能

文档 MCP 提供单个工具:

工具用途
search_docs搜索 EmDash 文档。返回带有源 URL 和匹配分数的相关片段。

在幕后,它使用 Cloudflare AI Search 对从 docs.emdashcms.com 构建的索引进行搜索。爬虫使索引与发布的站点保持同步,因此答案反映了您正在阅读的文档。

连接它

服务器可通过以下端点访问,无需身份验证或 API 密钥。它是公开且只读的。

https://docs.emdashcms.com/mcp

EmDash 模板中的自动发现

如果您从 EmDash 模板(npm create emdash)启动项目,三个配置文件已经就位,将自动被检测到:

文件使用者
.mcp.jsonClaude Code
.cursor/mcp.jsonCursor
.vscode/mcp.jsonVS Code

打开项目并接受工具在首次运行时显示的工作区信任提示。不需要进一步的设置。

手动设置

如果您不使用模板,或使用不同的工具,请使用客户端的代码片段一次性添加它:

Claude Code

以下命令使用 Claude Code CLI 添加服务器:

claude mcp add --transport http emdash-docs https://docs.emdashcms.com/mcp

或者,在项目根目录提交一个包含以下内容的 .mcp.json 文件:

{
  "mcpServers": {
    "emdash-docs": {
      "type": "http",
      "url": "https://docs.emdashcms.com/mcp"
    }
  }
}

OpenCode

将以下条目添加到 opencode.jsonc

{
  "mcp": {
    "emdash-docs": {
      "type": "remote",
      "url": "https://docs.emdashcms.com/mcp"
    }
  }
}

Cursor

在项目根目录提交一个包含以下内容的 .cursor/mcp.json 文件,或通过 Cursor Settings -> MCP -> Add new MCP server 添加服务器:

{
  "mcpServers": {
    "emdash-docs": {
      "type": "http",
      "url": "https://docs.emdashcms.com/mcp"
    }
  }
}

VS Code

将以下条目添加到项目中的 .vscode/mcp.json,或添加到用户设置:

{
  "servers": {
    "emdash-docs": {
      "type": "http",
      "url": "https://docs.emdashcms.com/mcp"
    }
  }
}

Claude Desktop

Claude Desktop 本身只支持 stdio MCP 服务器,因此使用 mcp-remote 作为桥接。将以下条目添加到 claude_desktop_config.json

{
  "mcpServers": {
    "emdash-docs": {
      "command": "npx",
      "args": ["mcp-remote", "https://docs.emdashcms.com/mcp"]
    }
  }
}

何时使用它

  • 您正在构建 EmDash 网站,并希望您的 AI 助手从当前文档中查找正确的 API、钩子名称或配置选项,而不是从半记得的训练数据中查找。
  • 您正在编写插件,想要了解哪些钩子以什么顺序触发。
  • 您正在移植 WordPress 主题,想要种子文件模式的示例。
  • 您遇到错误卡住了,想要搜索发布说明和概念。

在您的 AGENTS.md 中推荐它

如果您的项目使用 AGENTS.md(或 CLAUDE.md.cursorrules 等)来指导 AI 工具,请将它们指向文档 MCP,以便它们优先使用真实文档而不是假设:

## Documentation

Look up EmDash documentation via the `emdash-docs` MCP server when you need to
verify an API, hook, config option, or pattern. Prefer the docs MCP over
assumptions from training data -- the docs reflect the current published
behaviour.

EmDash 启动模板预装了此代码片段。