Counsel MCP

🚀 Counsel MCP Server

このオープンソースのModel Context Protocol (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クライアントによって自動的に処理されます。

セルフホスト型の場合

前提条件

1. システムにNode.js 18以上がインストールされていること
2. counsel.getmason.devにCounselアカウントがあること

Claude Desktop

claude_desktop_config.jsonに以下を追加します。

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

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

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クライアント

サーバーは2つのトランスポートモードをサポートしています。クライアントの機能に基づいて選択してください。

STDIOモード（デフォルト）

ほとんどのMCPクライアントはSTDIOトランスポートを使用します。以下のように設定します。

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

OAuthを使用したHTTPモード

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キーは不要です。

トランスポートの比較

🔐 認証

サーバーは2つの認証モードをサポートしています。

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

複雑な質問を多面的に分析するための新しい戦略的コンサルテーション（議論）を開始します。

例:

「モノリシックアプリケーションをマイクロサービスに移行すべきか？」についてのコンサルテーションを開始し、50人のエンジニアリングチームに関するコンテキストを考慮し、分析モードをdeepに設定します。

get_consultation_status

進行中のコンサルテーションのステータスを確認します。

get_consultation_report

完了したコンサルテーションから最終的な総合レポートを取得します。

list_consultations

過去のコンサルテーションを一覧表示します。

sharpen_question

コンサルテーションを開始する前に、戦略的な質問を洗練して改善します。

例:

「AIは当社にとって良いか？」という質問を洗練します。

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）

🐞 トラブルシューティング

"Tool not found"エラー

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 Platform - 戦略的推論プラットフォーム
• MCP Specification - Model Context Protocolのドキュメント
• GitHub Issues - バグ報告や機能リクエスト
• GitHub Discussions - 質問する