MCP 文档服务器

一个定制版的 MCP 文档服务器，通过模型上下文协议 (Model Context Protocol) 实现 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)

快速开始

设置和运行

# 克隆仓库
git clone https://github.com/esakrissa/mcp-doc.git
cd mcp-doc

# 创建并激活虚拟环境
python -m venv venv
source venv/bin/activate  # 在 Windows 上: venv\Scripts\activate

# 以开发模式安装包
pip install -e .

运行服务器

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

# 使用配置文件运行服务器
mcpdoc \
    --json config.json \
    --transport sse \
    --port 8082 \
    --host localhost

或者，如果您喜欢使用 UV：

# 安装 uv (如果尚未安装)
curl -LsSf https://astral.sh/uv/install.sh | sh

# 使用 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 的自定义指令中：

对于任何关于 LangGraph 和模型上下文协议 (MCP) 的问题，请使用 mcp-doc 服务器来帮助回答 --
+ 调用 list_doc_sources 工具来获取可用的文档文件
+ 调用 fetch_docs 工具来读取 langgraph.txt 或 mcp.txt 文件
+ 反思 langgraph.txt 或 mcp.txt 中的 URL
+ 反思输入问题
+ 对与问题相关的任何 URL 调用 fetch_docs
+ 使用这些信息来回答问题

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

安全提示

出于安全原因，实施了严格的域访问控制：

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

参考

本项目基于 LangChain AI 的原始 mcpdoc 修改而来，旨在为 LangGraph 和 MCP 提供集中的文档访问。