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 工具。