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

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

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

1. 安装依赖项：

   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": {}
       }
       }
   }

1. 保存配置。点击 Refresh 在MCP设置中。
2. 服务器现在应该可以作为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