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 啟動範本預裝了此程式碼片段。