MCP Documentation Server

MCP 文档服务

这是一个定制版 MCP 文档服务，可通过模型上下文协议，在 LLM 应用（如 Cursor、Claude Desktop、Windsurf）与文档来源之间实现集成。

概述

此服务为 MCP 主机应用提供：

1. 访问特定文档文件（langgraph.txt 和 mcp.txt）
2. 用于从这些文件中的 URL 获取文档的工具

支持的文档

目前已配置以下文档：

• LangGraph 文档（来自 https://raw.githubusercontent.com/esakrissa/mcp-doc/main/docs/langgraph.txt）
• MCP 文档（来自 https://raw.githubusercontent.com/esakrissa/mcp-doc/main/docs/mcp.txt）

快速开始

设置并运行

# Clone the repository
git clone https://github.com/esakrissa/mcp-doc.git
cd mcp-doc

# Create and activate a virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install the package in development mode
pip install -e .

运行服务

你可以使用已安装的命令运行服务：

# Run the server with the config file
mcpdoc \
    --json config.json \
    --transport sse \
    --port 8082 \
    --host localhost

如果你更喜欢使用 UV，也可以运行：

# Install uv (if not already installed)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Run the server with UV
uvx --from mcpdoc mcpdoc \
    --json config.json \
    --transport sse \
    --port 8082 \
    --host localhost

IDE 集成

Cursor

添加到 ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-doc": {
      "command": "uvx",
      "args": [
        "--from",
        "mcpdoc",
        "mcpdoc",
        "--urls",
        "LangGraph:https://raw.githubusercontent.com/esakrissa/mcp-doc/main/docs/langgraph.txt",
        "ModelContextProtocol:https://raw.githubusercontent.com/esakrissa/mcp-doc/main/docs/mcp.txt",
        "--allowed-domains",
        "*",
        "--transport",
        "stdio"
      ]
    }
  }
}

然后将以下说明添加到 Cursor 的自定义说明中：

for ANY question about LangGraph and Model Context Protocol (MCP), use the mcp-doc server to help answer -- 
+ call list_doc_sources tool to get the available documentation files
+ call fetch_docs tool to read the langgraph.txt or mcp.txt file
+ reflect on the urls in langgraph.txt or mcp.txt 
+ reflect on the input question 
+ call fetch_docs on any urls relevant to the question
+ use this to answer the question

若要测试集成是否正常，请向 Cursor 询问有关 LangGraph 或 MCP 的问题，并检查它是否使用文档服务工具获取信息。

安全说明

出于安全考虑，此服务实施了严格的域名访问控制：

• 远程文档文件：仅自动允许特定域名
• 本地文档文件：不会自动允许任何域名
• 使用 --allowed-domains 显式添加域名，或使用 --allowed-domains '*' 允许所有域名（请谨慎使用）

参考

此项目基于 LangChain AI 的原始项目 mcpdoc，经过修改，为 LangGraph 和 MCP 提供精简的文档访问功能。