文档集成服务器

一个定制化的MCP文档服务器,通过模型上下文协议实现LLM应用与文档源的集成,提供特定文档文件的访问和URL抓取工具。

  • by esakrissa
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 esakrissa/mcp-doc

使用说明

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/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提供了集中的文档访问权限。