Cortex Cloud Docs MCP Server

🚀 Cortex Cloud Docs MCP Server

Cortex Cloudのドキュメントに検索アクセスを提供するModel Context Protocol (MCP)サーバーです。このサーバーにより、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. リポジトリをフォークする
2. 機能ブランチを作成する
3. 変更を加える
4. Claude Desktopでテストする
5. プルリクエストを送信する

トラブルシューティング

Claude Desktopでサーバーが起動しない場合

1. uvがインストールされており、PATHに含まれていることを確認する
2. プロジェクトディレクトリのパスが正しいことを確認する
3. Claude Desktopのログを確認して、具体的なエラーメッセージを確認する

依存関係が不足している場合

すべての依存関係がインストールされていることを確認するには、uv syncを実行してください。

ドキュメントが見つからない場合

サーバーは最初にドキュメントをインデックス化する必要があります。検索する前にindex_cortex_docsまたはindex_cortex_api_docsツールを使用してください。