Counsel MCP

🚀 Counsel MCP 服務器

Counsel MCP 服務器是一個開源的 模型上下文協議 (MCP) 服務器，它能將 AI 代理連接到 Counsel API，以進行戰略推理和多視角分析。

✨ 主要特性

• 託管與自託管模式：可立即使用託管服務器，也能自行運行實例。
• 戰略推理：訪問 Counsel 的辯論和多視角推理引擎。
• 顧問會話：運行交互式信息收集和配置文件調整會話。
• 原生 OAuth 2.0：客戶端自動處理標準 MCP 身份驗證。
• 雙傳輸模式：本地客戶端使用 STDIO，Web 客戶端和共享服務器使用 HTTP。

🚀 快速開始

託管模式

無需安裝，可立即連接到託管的 Counsel MCP 服務器：

http://counsel-mcp.getmason.dev/mcp

對於支持 HTTP 傳輸的 MCP 客戶端，只需添加以下配置：

{
  "mcpServers": {
    "counsel": {
      "url": "http://counsel-mcp.getmason.dev/mcp",
      "transport": "http"
    }
  }
}

OAuth 身份驗證由 MCP 客戶端自動處理。

📦 安裝指南

自託管模式

可在本地運行自己的 Counsel MCP 服務器實例。

前提條件

1. 系統已安裝 Node.js 18+。
2. 在 counsel.getmason.dev 擁有 Counsel 賬戶。

Claude Desktop

將以下配置添加到 claude_desktop_config.json 文件中：

Claude Code (CLI)

claude mcp add counsel -- npx -y counsel-mcp-server start

或者手動添加到 MCP 設置中：

{
  "mcpServers": {
    "counsel": {
      "command": "npx",
      "args": ["-y", "counsel-mcp-server", "start"]
    }
  }
}

Cursor

將以下配置添加到 Cursor MCP 配置文件（項目或全局設置中的 .cursor/mcp.json）：

{
  "mcpServers": {
    "counsel": {
      "command": "npx",
      "args": ["-y", "counsel-mcp-server", "start"]
    }
  }
}

Windsurf

將以下配置添加到 Windsurf MCP 配置文件：

{
  "mcpServers": {
    "counsel": {
      "command": "npx",
      "args": ["-y", "counsel-mcp-server", "start"]
    }
  }
}

VS Code with Copilot

將以下配置添加到 VS Code 設置文件 (settings.json)：

{
  "mcp.servers": {
    "counsel": {
      "command": "npx",
      "args": ["-y", "counsel-mcp-server", "start"]
    }
  }
}

其他 MCP 客戶端

服務器支持兩種傳輸模式，可根據客戶端功能選擇：

STDIO 模式（默認）

大多數 MCP 客戶端使用 STDIO 傳輸，配置如下：

{
  "mcpServers": {
    "counsel": {
      "command": "npx",
      "args": ["-y", "counsel-mcp-server", "start"],
      "env": {
        "COUNSEL_API_KEY": "your_api_key_here"
      }
    }
  }
}

HTTP 模式（帶 OAuth）

對於支持帶 OAuth 2.0 的 HTTP 傳輸的客戶端，需單獨運行服務器：

# 啟動 HTTP 服務器
npx -y counsel-mcp-server http --port 3000

此命令將啟動一個 HTTP 服務器，具有以下端點：

• MCP 端點：http://localhost:3000/mcp
• OAuth 發現：http://localhost:3000/.well-known/oauth-authorization-server 然後配置客戶端進行連接：

{
  "mcpServers": {
    "counsel": {
      "url": "http://localhost:3000/mcp",
      "transport": "http"
    }
  }
}

HTTP 模式使用 OAuth 2.0 進行自動令牌管理，無需 API 密鑰。

傳輸模式比較

🔐 身份驗證

服務器支持兩種身份驗證模式：

STDIO 模式（默認）

從 counsel.getmason.dev 獲取 API 密鑰，並設置 COUNSEL_API_KEY 環境變量：

export COUNSEL_API_KEY=your_api_key_here

或者將其添加到 MCP 客戶端配置中：

{
  "mcpServers": {
    "counsel": {
      "command": "npx",
      "args": ["-y", "counsel-mcp-server", "start"],
      "env": {
        "COUNSEL_API_KEY": "your_api_key_here"
      }
    }
  }
}

HTTP 模式（OAuth 2.0）

當以 HTTP 模式運行時（npx -y counsel-mcp-server http），身份驗證通過 OAuth 2.0 自動處理：

1. 首次使用 Counsel 工具時，MCP 客戶端將提示進行身份驗證。
2. 會被重定向到使用 Counsel 賬戶登錄。
3. 授權後，令牌將自動管理。 在 HTTP 模式下 無需手動設置 API 密鑰，MCP 客戶端會處理整個 OAuth 流程。

OAuth 端點（HTTP 模式）

服務器提供標準的 OAuth 2.0 端點：

🛠️ 可用工具

start_consultation

啟動新的戰略諮詢（辯論），以多視角分析複雜問題。

針對“我們是否應該在 2025 年將單體應用遷移到微服務？”啟動諮詢，提供關於我們 50 人工程團隊的上下文，並將模式設置為深度分析

get_consultation_status

檢查正在進行的諮詢的狀態。

get_consultation_report

從已完成的諮詢中獲取最終綜合報告。

list_consultations

列出過去的諮詢。

sharpen_question

在啟動諮詢之前完善和改進戰略問題。

完善這個問題：“人工智能對我們公司有好處嗎？”

consult_advisor

啟動交互式顧問會話，用於頭腦風暴或問題界定。

💻 使用示例

戰略決策

使用 Counsel 分析：“我們是否應該在 2025 年拓展歐洲市場？”
考慮這些利益相關者：CEO、CFO、銷售主管、法務
使用深度分析模式

問題完善

使用 sharpen_question 工具完善這個問題：
“我們如何改善公司文化？”
上下文：我們是一家 200 人的初創公司，正在經歷快速增長

檢查諮詢進度

檢查諮詢 abc-123-def 的狀態

⚙️ 配置

環境變量

CLI 命令

# STDIO 模式（默認） - 適用於大多數 MCP 客戶端
npx -y counsel-mcp-server start

# HTTP 模式 - 適用於支持 OAuth 的客戶端
npx -y counsel-mcp-server http [選項]

HTTP 選項:
  -p, --port <port>  監聽端口（默認：3000）
  --host <host>      綁定的主機（默認：localhost）

🐞 故障排除

“工具未找到”錯誤

確保 MCP 服務器在客戶端中配置正確。添加配置後重啟客戶端。

身份驗證問題

1. 檢查是否擁有有效的 Counsel 賬戶。
2. 嘗試刪除並重新添加 MCP 服務器配置。
3. 如果可用，清除客戶端的 MCP 緩存。

連接被拒絕

如果以 HTTP 模式運行，確保：

• 服務器正在運行（npx counsel-mcp-server start）。
• 端口未被防火牆阻止。
• 沒有其他進程使用相同的端口。

服務器無法啟動

# 檢查 Node.js 版本（需要 18+）
node --version

# 嘗試直接運行以查看錯誤信息
npx counsel-mcp-server start

調試模式

如需詳細日誌記錄，可檢查 MCP 客戶端的日誌，或直接在終端中運行服務器以查看輸出。

🛠️ 開發

前提條件

• Node.js 18+
• npm 9+

環境搭建

git clone https://github.com/mercurialsolo/counsel-mcp.git
cd counsel-mcp-server
npm install
npm run build

命令

npm run build            # 編譯 TypeScript
npm run dev              # 監聽模式
npm run start            # 運行服務器
npm test                 # 運行測試
npm run lint             # 類型檢查
npm run security:check   # 掃描暫存文件中的敏感信息
npm run security:check:all  # 掃描所有文件中的敏感信息

安全

本項目包含自動敏感信息檢測：

• 預提交鉤子：每次提交前自動掃描暫存文件。
• CI 集成：所有拉取請求都會運行安全檢查。
• 模式檢測：檢測 AWS 密鑰、GitHub 令牌、API 密鑰、私鑰等。 詳情請參閱 CONTRIBUTING.md。

項目結構

src/
├── index.ts        # HTTP 服務器、OAuth 代理、MCP 傳輸
├── client.ts       # 帶有請求範圍身份驗證的 API 客戶端
├── config.ts       # 環境配置
└── tools/
    ├── debates.ts  # 諮詢工具
    └── advisor.ts  # 顧問會話工具

🤝 貢獻

我們歡迎貢獻！請參閱 CONTRIBUTING.md 獲取指南。

快速開始

1. 分叉倉庫。
2. 創建功能分支：git checkout -b feature/your-feature。
3. 進行更改並添加測試。
4. 運行 npm test 確保測試通過。
5. 提交拉取請求。

📄 許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE。

🔗 鏈接

• Counsel 平臺 - 戰略推理平臺
• MCP 規範 - 模型上下文協議文檔
• GitHub 問題 - 報告 bug 或請求功能
• GitHub 討論 - 提問