AI导哈

文档搜索服务器

一个提供Cortex Cloud文档搜索访问的模型上下文协议（MCP）服务器，支持实时索引和缓存优化。

  • by clarkemn
  • Python
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 clarkemn/cortex-cloud-docs-mcp-server

使用说明

Cortex Cloud Docs MCP服务器

一种模型上下文协议（MCP）服务器，提供对Cortex Cloud文档的搜索访问。该服务器允许Claude和其他兼容MCP的客户端搜索Cortex Cloud的官方文档和API参考资料。

特性

  • 在Cortex Cloud文档中搜索
  • 搜索Cortex Cloud API文档
  • 提高性能的缓存系统
  • 文档网站的实时索引

安装

选项1：来自PyPI（推荐）

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

通过Smithery安装

通过以下方式自动安装Claude Desktop的cortex cloud docs mcp服务器 史密瑟里:

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

选项2：开发安装

先决条件

  • Python 3.12或更高版本
  • 紫外线 包管理器

安装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配置文件中：

地点： ~/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) -Index 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              # Main MCP server implementation
├── pyproject.toml         # Project configuration
├── uv.lock               # Dependency lock file
└── README.md             # This file

许可证

MIT许可证-有关详细信息，请参阅许可证文件。

贡献

  1. 分叉存储库
  2. 创建要素分支
  3. 进行更改
  4. 使用Claude Desktop进行测试
  5. 提交拉取请求

故障排除

服务器未在Claude Desktop中启动

  1. 确保 uv 已安装并位于您的PATH中
  2. 验证项目目录的路径是否正确
  3. 检查Claude Desktop日志中的特定错误消息

缺少的依赖

跑 uv sync 以确保安装了所有依赖项。

未找到文档

服务器需要先索引文档。使用 index_cortex_docs 或 index_cortex_api_docs 搜索前的工具。

相关 MCP