🚀 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 文件。
贡献指南
- Fork 此仓库。
- 创建一个功能分支。
- 进行更改。
- 使用 Claude Desktop 进行测试。
- 提交拉取请求。
🚧 故障排除
Claude Desktop 中服务器无法启动
- 确保
uv已安装并已添加到系统路径中。 - 验证项目目录的路径是否正确。
- 查看 Claude Desktop 日志以获取具体的错误信息。
缺少依赖项
运行 uv sync 以确保所有依赖项都已安装。
未找到文档
服务器需要先对文档进行索引。在搜索之前，请使用 index_cortex_docs 或 index_cortex_api_docs 工具。