Cortex Cloud Docs MCP Server

🚀 Cortex Cloud Docs MCP Server

Cortex Cloud Docs MCP Server 是一个模型上下文协议（MCP）服务器，它为 Cortex Cloud 文档提供搜索访问功能。该服务器允许 Claude 及其他兼容 MCP 的客户端搜索 Cortex Cloud 的官方文档和 API 参考。

✨ 主要特性

• 可在 Cortex Cloud 文档中进行搜索。
• 支持搜索 Cortex Cloud API 文档。
• 具备缓存系统，以提升性能。
• 能对文档站点进行实时索引。

📦 安装指南

选项 1：从 PyPI 安装（推荐）

无需安装！只需在你的 Claude Desktop 配置中使用 uvx 即可。

通过 Smithery 安装

若要通过 Smithery 为 Claude Desktop 自动安装 cortex-cloud-docs-mcp-server，可执行以下命令：

npx -y @smithery/cli install @clarkemn/cortex-cloud-docs-mcp-server --client claude

选项 2：开发环境安装

前提条件

• Python 3.12 或更高版本。
• uv 包管理器。

安装 uv

curl -LsSf https://astral.sh/uv/install.sh | sh

克隆并设置

git clone https://github.com/clarkemn/cortex-cloud-docs-mcp-server.git
cd cortex-cloud-docs-mcp-server
uv sync

💻 使用示例

与 Claude Desktop 配合使用

将此服务器添加到你的 Claude Desktop 配置文件中： 位置：~/Library/Application Support/Claude/claude_desktop_config.json（macOS）

选项 1：直接从 PyPI 安装（推荐）

{
  "mcpServers": {
    "Cortex Cloud Docs": {
      "command": "uvx",
      "args": ["cortex-cloud-docs-mcp-server@latest"],
      "env": {},
      "transport": "stdio"
    }
  }
}

选项 2：本地开发

{
  "mcpServers": {
    "Cortex Cloud Docs": {
      "command": "uv",
      "args": ["run", "python", "server.py"],
      "cwd": "/path/to/cortex-cloud-docs-mcp-server",
      "env": {},
      "transport": "stdio"
    }
  }
}

请将 /path/to/cortex-cloud-docs-mcp-server 替换为你克隆此仓库的实际路径。

手动测试

你可以手动测试服务器：

echo '{"jsonrpc": "2.0", "id": 1, "method": "initialize", "params": {"protocolVersion": "2024-11-05", "capabilities": {}, "clientInfo": {"name": "test", "version": "1.0"}}}' | uv run python server.py

可用工具

服务器提供以下 MCP 工具：

• index_cortex_docs(max_pages: int = 50) - 对 Cortex Cloud 文档进行索引（建议先调用此工具）
• index_cortex_api_docs(max_pages: int = 50) - 对 Cortex Cloud API 文档进行索引
• search_cortex_docs(query: str) - 搜索 Cortex Cloud 文档
• search_cortex_api_docs(query: str) - 搜索 Cortex Cloud API 文档
• search_all_docs(query: str) - 搜索所有已索引的文档
• get_index_status() - 检查索引状态和缓存统计信息

🔧 技术细节

运行服务器

uv run python server.py

安装依赖

uv sync

项目结构

cortex-cloud-docs-mcp-server/
├── server.py              # 主要的 MCP 服务器实现
├── pyproject.toml         # 项目配置
├── uv.lock               # 依赖锁定文件
└── README.md             # 本文件

📄 许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

贡献指南

1. Fork 此仓库。
2. 创建一个功能分支。
3. 进行更改。
4. 使用 Claude Desktop 进行测试。
5. 提交拉取请求。

🚧 故障排除

Claude Desktop 中服务器无法启动

1. 确保 uv 已安装并已添加到系统路径中。
2. 验证项目目录的路径是否正确。
3. 查看 Claude Desktop 日志以获取具体的错误信息。

缺少依赖项

运行 uv sync 以确保所有依赖项都已安装。

未找到文档

服务器需要先对文档进行索引。在搜索之前，请使用 index_cortex_docs 或 index_cortex_api_docs 工具。