Prisma Cloud Docs MCP Server

🚀 Prisma Cloud Docs MCP Server

Prisma Cloudのドキュメントを検索するためのModel Context Protocol (MCP)サーバーです。このサーバーを使用すると、Claudeやその他のMCP互換クライアントがPrisma Cloudの公式ドキュメントやAPIリファレンスを検索できます。

🚀 クイックスタート

このサーバーは、Prisma CloudのドキュメントやAPIリファレンスを検索するためのMCPサーバーです。Claudeやその他のMCP互換クライアントから利用できます。

✨ 主な機能

• Prisma Cloudのドキュメント全体を検索
• Prisma CloudのAPIドキュメントを検索
• パフォーマンス向上のためのキャッシュシステム
• ドキュメントサイトのリアルタイムインデックス

📦 インストール

オプション1: PyPIからのインストール (推奨)

インストールは不要です！Claude Desktopの設定でuvxを使用してください。

Smithery経由でのインストール

Smitheryを介してClaude Desktop用のprisma-cloud-docs-mcp-serverを自動的にインストールするには、以下のコマンドを実行します。

npx -y @smithery/cli install @clarkemn/prisma-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/prisma-cloud-docs-mcp-server.git
cd prisma-cloud-docs-mcp-server
uv sync

💻 使用例

Claude Desktopでの使用

Claude Desktopの設定ファイルにこのサーバーを追加します。

場所: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)

オプション1: PyPIから直接使用 (推奨)

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

オプション2: ローカル開発用

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

/path/to/prisma-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_prisma_docs(max_pages: int = 50) - Prisma Cloudのドキュメントをインデックス化 (最初に実行することを推奨)
• index_prisma_api_docs(max_pages: int = 50) - Prisma CloudのAPIドキュメントをインデックス化
• search_prisma_docs(query: str) - Prisma Cloudのドキュメントを検索
• search_prisma_api_docs(query: str) - Prisma CloudのAPIドキュメントを検索
• search_all_docs(query: str) - すべてのインデックス化されたドキュメントを検索
• get_index_status() - インデックス化の状態とキャッシュ統計を確認

🔧 技術詳細

サーバーの実行

uv run python server.py

依存関係のインストール

uv sync

プロジェクト構造

prisma-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_prisma_docs または index_prisma_api_docs ツールを使用してください。