Prisma Cloud Docs MCP Server

🚀 Prisma Cloud Docs MCP Server

Prisma Cloud Docs MCP Server 是一個模型上下文協議（MCP）服務器，它為 Prisma Cloud 文檔提供搜索訪問功能。藉助該服務器，Claude 及其他支持 MCP 的客戶端能夠搜索 Prisma Cloud 的官方文檔和 API 參考資料。

✨ 主要特性

• 可對 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. Fork 該倉庫。
2. 創建功能分支。
3. 進行修改。
4. 使用 Claude Desktop 進行測試。
5. 提交拉取請求。

❓ 故障排除

Claude Desktop 中服務器無法啟動

1. 確保 uv 已安裝並已添加到系統的 PATH 環境變量中。
2. 驗證項目目錄的路徑是否正確。
3. 查看 Claude Desktop 日誌以獲取具體的錯誤信息。

缺少依賴項

運行 uv sync 以確保所有依賴項都已安裝。

未找到文檔

服務器需要先對文檔進行索引。在搜索之前，請使用 index_prisma_docs 或 index_prisma_api_docs 工具進行索引操作。