AI导哈

文档协议服务器

一个提供对Particle Network通用账户文档访问的MCP服务器，具有资源访问、内容缓存、内容解析和搜索功能。

  • by Particle-Network
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 particle-network/particle-docs-mcp-server

使用说明

粒子MCP服务器

MCP（模型上下文协议）服务器，提供对选定粒子网络通用帐户文档的访问。

特性

  • 资源访问：将9个关键的粒子通用账户文档作为MCP资源公开。
  • 内容缓存：具有可配置TTL的智能缓存（默认为24小时）。
  • 内容解析：文档的结构化解析，包括部分、代码块和链接。
  • 搜索功能：搜索所有文档内容。
  • 内置工具：包括用于搜索、刷新和列出页面的工具。

安装

  1. 克隆存储库：

    git clone https://github.com/soos3d/particle-mcp-server.git
cd particle-mcp-server

  2. 创建并激活虚拟环境：

    python3 -m venv .venv
source .venv/bin/activate

  3. 安装依赖项：

    pip install -r requirements.txt

运行服务器

您可以直接从命令行运行服务器：

python3 main.py

服务器将通过以下方式启动并监听MCP协议消息 stdio.

IDE设置

风帆设置

要将此服务器用作Windsurf中的工具源，请执行以下操作：

  1. 首选 Windsurf > Settings > Windsurf Settings > Cascade > Manage MCPs.
  2. 点击 View Raw Config，这将打开一个JSON文件， mcp_config.json.
  3. 添加以下配置：
    {
    "mcpServers": {
    "particle-docs": {
        "command": "/YOUR-PATH-TO/particle-mcp-server/.venv/bin/python3",
        "args": ["/YOUR-PATH-TO/particle-mcp-server/main.py"],
        "env": {}
    }
    }
}
  4. 保存配置。点击 Refresh 在MCP设置中。
  5. 服务器现在应该可以作为Windsurf中的工具使用。

可用工具

服务器公开了以下工具：

  • search_docs：搜索所有文档。
  • refresh_resource：强制刷新特定页面的缓存内容。
  • list_pages：列出所有可用的文档页面。

项目结构

particle-mcp-server/
├── src/                  # Source code
│   ├── server.py         # Main MCP server implementation
│   ├── config.py         # Configuration and page definitions
│   ├── docs_fetcher.py   # Fetches and caches documentation
│   ├── docs_parser.py    # Parses and structures content
│   └── resources.py      # MCP resource handlers
├── data/cache/           # Cached documentation content
├── requirements.txt      # Python dependencies
└── main.py               # Entry point

相关 MCP