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 工具进行索引操作。