使用说明(简明版,便于快速理解与上手)
-
项目简介
- Claude Power Pack 是一个以 MCP 为基础的后端服务集成体,包含三个主要 MCP 服务器:Second Opinion(代码评审与多模型对比)、Playwright Persistent(浏览器自动化的持久会话)、Coordination(基于 Redis 的分布式锁与会话管理)。它们共同向种类多样的 MCP 客户端提供资源管理、工具调用、以及可自定义的提示模板渲染能力。
-
主要功能点
- 多模型对话与对比:支持 Gemini、OpenAI 等多家模型的对话与并行对比,以及对话成本、tokens 的统计与跟踪。
- 工具化能力:可让模型调用网页检索、读取网页文本、浏览器自动化等工具来获取实时信息。
- 持久化浏览器会话:在一个会话中维持浏览器状态、标签页、Cookies 等,以实现持续的页面交互。
- 安全与治理:提供 SSRF 保护、域名审批、输出遮罩等安全特性,减少敏感信息暴露与不安全请求。
- 会话与协调:通过 Redis 实现会话注册、心跳、锁的分布式管理,支持多会话并发协作。
-
安装步骤
- 依赖环境:Python 3.11+,建议使用 Conda 虚拟环境。
- 下载代码后进入仓库根目录,安装 MCP 相关依赖并配置所需 API Keys(Gemini/OpenAI),再分别启动三个 MCP 服务器:
- Second Opinion(端口 8080,传输 SSE)
- Playwright Persistent(端口 8081,传输 SSE)
- Coordination(端口 8082,传输 SSE)
- 启动前请确保 Redis 已就绪并可访问(Coordination 服务依赖 Redis)。
-
服务器配置(供 MCP 客户端使用的配置信息,JSON 格式,描述 server name、启动命令及参数等) JSON 示例(如用于 Claude 客户端连接的配置,在实际使用中请按需调整参数) { "server_name": "second-opinion", "command": "python", "args": [ "-m", "mcp-second-opinion.src.server", "--transport", "sse", "--host", "0.0.0.0", "--port", "8080" ], "description": "Second Opinion MCP Server:多模型对比与代码评审服务,使用 SSE 传输。" } 说明与要点:
- server_name:服务器的名称标识,与客户端在连接、注册时会显示的名称一致,便于区分。
- command/args:启动服务器的命令及参数,至少包含启动脚本路径、传输协议及监听地址与端口。
- 端口分配:三个服务器分别使用 8080、8081、8082,确保网络环境允许对应端口的通信。
- 运行时注意:MCP 客户端需要通过其配置连接到对应的 URL,例如 http://<host>:8080/sse(Second Opinion)、http://<host>:8081/sse(Playwright)、http://<host>:8082/sse(Coordination)。
- 安全与 API Keys:Second Opinion 需要 Gemini/OpenAI 的 API Key,Playwright 与 Coordination 的具体访问取决于各自服务实现与密钥配置。
-
基本使用方法
- 启动服务器
- 启动 Second Opinion、Playwright Persistent、Coordination 三个 MCP 服务(分别监听 8080、8081、8082,传输方式为 SSE)。
- 配置 MCP 客户端
- 客户端需要知道服务器的名称、启动命令与参数等信息,建立与 MCP 服务器的连接,并通过相应的传输通道与 API 调用进行资源读取、工具调用、Prompts 渲染等操作。
- 常用操作概览
- 向模型发起对话、请求多模型对比分析
- 调用工具(如网页检索、URL 获取、浏览器操作等)以获取外部信息
- 通过会话管理功能,创建、维护、结束多-turn 的对话段落
- 使用 Coordination 提供的分布式锁,避免并发冲突
- 注意事项
- 在生产环境中务必配置正确的 API 密钥、SSRF 安全策略,以及对输出进行必要的掩码处理,避免敏感信息外泄。
- 启动服务器
信息
分类
AI与计算