SuperAPI AI 工具集

counsel-mcp

counsel-mcp 是一个开源的 Model Context Protocol(MCP)服务器,用于将 AI 智能体连接到 Counsel API,实现战略推理与多视角分析。它支持托管与自托管两种使用方式:既可直接接入托管服务器,也可在本地自行运行实例。核心能力包括访问 Counsel 的辩论与多视角推理引擎、运行交互式顾问会话(用于问题梳理与画像调优),并原生支持 OAuth 2.0 认证(由 MCP 客户端自动处理),同时提供 STDIO 与 HTTP 双传输方式,分别面向本地客户端和 Web 客户端或共享服务器。自托管需 Node.js 18+ 及 Counsel 账号,配置方式涵盖 Claude Desktop、Claude Code(CLI)、Cursor、Windsurf、VS Code with Copilot 等客户端。内置工具包括 start_consultation、get_consultation_status、get_consultation_report、list_consultations、sharpen_question 和 consult_advisor,可用于启动战略咨询、检查进度、获取综合报告、列出历史咨询、优化问题以及开启顾问会话。项目采用 MIT 许可证。

访问官网

工具介绍

Counsel MCP Server 是一个开源的 Model Context Protocol(MCP)服务器,用于把 AI 智能体连接到 Counsel API,从而获得战略推理和多视角分析能力。它面向需要借助结构化辩论与多方视角来审视复杂问题的使用场景。

一、主要能力 根据官方资料,该服务器提供以下特性:

  • 托管与自托管:可立即使用托管服务器,也可自行运行实例。
  • 战略推理:访问 Counsel 的辩论与多视角推理引擎。
  • 顾问会话:运行交互式的信息采集(intake)与画像调优(profile tuning)会话。
  • 原生 OAuth 2.0:由 MCP 客户端自动处理标准 MCP 认证。
  • 双传输:STDIO 用于本地客户端,HTTP 用于 Web 客户端和共享服务器。

二、可用工具

  • start_consultation:启动新的战略咨询(辩论),从多个视角分析复杂问题。
  • get_consultation_status:检查正在进行的咨询状态。
  • get_consultation_report:获取已完成咨询的最终综合报告。
  • list_consultations:列出过往咨询。
  • sharpen_question:在开始咨询前,优化和改进战略性问题。
  • consult_advisor:启动交互式顾问会话,用于头脑风暴或界定问题范围。

三、使用方式

  1. 快速开始(托管) 可直接连接托管的 Counsel MCP 服务器,无需安装。对于支持 HTTP 传输的 MCP 客户端,直接添加配置即可,OAuth 认证由 MCP 客户端自动处理。

  2. 自托管安装 需要 Node.js 18+,以及位于 counsel.getmason.dev 的 Counsel 账号。 支持在以下客户端中配置:Claude Desktop(claude_desktop_config.json)、Claude Code(CLI)、Cursor(.cursor/mcp.json 或全局设置)、Windsurf MCP 配置、VS Code with Copilot(settings.json),以及其他 MCP 客户端。

  3. 传输模式

  • STDIO:多数 MCP 客户端使用的传输方式,通过 COUNSEL_API_KEY 环境变量进行认证。
  • HTTP:面向支持 HTTP 传输与 OAuth 2.0 的客户端。运行命令为 npx -y counsel-mcp-server http,启动后提供 MCP 端点 http://localhost:3000/mcp 和 OAuth 发现端点 http://localhost:3000/.well-known/oauth-authorization-server。
  1. 认证模式
  • STDIO 模式(默认):设置 COUNSEL_API_KEY 环境变量(API Key 来自 counsel.getmason.dev),也可写入 MCP 客户端配置。
  • HTTP 模式(OAuth 2.0):首次使用 Counsel 工具时,MCP 客户端会提示认证,跳转登录 Counsel 账号;授权后 token 自动管理,无需手动 API Key。服务器暴露标准 OAuth 2.0 端点。

四、适用场景 资料中明确提到的场景包括:战略决策制定(Strategic Decision Making)、问题优化(Question Refinement)、检查咨询进度(Checking Consultation Progress)。

五、限制与故障排查 资料列出以下故障排查项:

  • “Tool not found”错误:确认 MCP 服务器已在客户端正确配置,添加配置后重启客户端。
  • 认证问题:检查是否拥有有效 Counsel 账号;尝试移除并重新添加 MCP 服务器配置;如可用,清除客户端 MCP 缓存。
  • 连接被拒:HTTP 模式下,确保服务器正在运行(npx counsel-mcp-server start)、端口未被防火墙阻止、没有其他进程占用同一端口。
  • 服务器无法启动:查看 MCP 客户端日志,或直接在终端运行服务器以查看输出;支持详细日志。

六、安全与项目信息 项目包含自动化密钥检测:pre-commit 钩子在每次提交前扫描暂存文件,CI 集成在所有拉取请求上运行安全检查,可检测 AWS 密钥、GitHub token、API Key、私钥等模式。 项目采用 MIT 许可证。欢迎贡献,流程为:Fork 仓库、创建功能分支(git checkout -b feature/your-feature)、修改并添加测试、运行 npm test 确保测试通过、提交拉取请求。

七、费用与价格 资料未提供关于费用、价格或收费模式的信息,暂未提供。