Counsel MCP Server

Counsel MCP Server

AI エージェントを Counsel API に接続し、戦略的な推論と多角的な分析を実現する、オープンソースの Model Context Protocol (MCP) サーバーです。

機能

• ホステッド＆セルフホスト可能 - ホステッドサーバーにすぐ接続するか、独自のインスタンスを実行できます
• 戦略的な推論 - Counsel のディベートエンジンと多角的な推論エンジンを利用できます
• アドバイザーセッション - 対話型の初回ヒアリングとプロファイル調整のセッションを実行できます
• ネイティブ OAuth 2.0 - 標準的な MCP 認証をクライアントが自動的に処理します
• 2 種類のトランスポート - ローカルクライアント向けの STDIO、ウェブクライアントと共有サーバー向けの HTTP

目次

• クイックスタート（ホステッド）
• インストール（セルフホスト）
  • Claude Desktop
  • Claude Code（CLI）
  • Cursor
  • Windsurf
  • Copilot 対応の VS Code
  • その他の MCP クライアント
• 認証
• 利用可能なツール
• 使用例
• 設定
• トラブルシューティング
• 開発
• コントリビューション
• ライセンス

クイックスタート（ホステッド）

インストール不要で、ホステッド版の 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 に追加します：

{
  "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 トランスポートに対応しているクライアントの場合、サーバーを別途実行します：

# Start the HTTP server
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 キー設定は不要です。OAuth フロー全体は MCP クライアントが処理します。

OAuth エンドポイント（HTTP モード）

サーバーは標準的な OAuth 2.0 エンドポイントを公開します。

利用可能なツール

start_consultation

複数の視点から複雑な質問を分析するため、新しい戦略コンサルテーション（ディベート）を開始します。

例：

Start a consultation about "Should we migrate our monolith to microservices?"
with context about our 50-person engineering team and mode set to deep

get_consultation_status

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

get_consultation_report

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

list_consultations

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

sharpen_question

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

例：

Sharpen this question: "Is AI good for our company?"

consult_advisor

ブレインストーミングや問題の範囲設定に使う、対話型アドバイザーセッションを開始します。

使用例

戦略的な意思決定

Use Counsel to analyze: "Should we expand into the European market in 2025?"

Consider these stakeholders: CEO, CFO, Head of Sales, Legal
Use deep analysis mode

質問の改善

Use the sharpen_question tool to improve this question:
"How do we fix our culture?"

Context: We're a 200-person startup experiencing rapid growth

コンサルテーションの進捗確認

Check the status of consultation abc-123-def

設定

環境変数

CLI コマンド

# STDIO mode (default) - for most MCP clients
npx -y counsel-mcp-server start

# HTTP mode - for clients supporting OAuth
npx -y counsel-mcp-server http [options]

HTTP Options:
  -p, --port <port>  Port to listen on (default: 3000)
  --host <host>      Host to bind to (default: localhost)

トラブルシューティング

「Tool not found」エラー

クライアントで MCP サーバーが適切に設定されていることを確認してください。設定を追加した後、クライアントを再起動してください。

認証の問題

1. 有効な Counsel アカウントを持っていることを確認してください
2. MCP サーバーの設定を削除してから、再度追加してみてください
3. 利用可能な場合は、クライアントの MCP キャッシュをクリアしてください

接続拒否

HTTP モードで実行している場合は、次の点を確認してください。

• サーバーが実行中であること（npx counsel-mcp-server start）
• ポートがファイアウォールによってブロックされていないこと
• 同じポートを使用している別のプロセスがないこと

サーバーが起動しない

# Check Node.js version (requires 18+)
node --version

# Try running directly to see errors
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            # Compile TypeScript
npm run dev              # Watch mode
npm run start            # Run server
npm test                 # Run tests
npm run lint             # Type check
npm run security:check   # Scan staged files for secrets
npm run security:check:all  # Scan all files for secrets

セキュリティ

このプロジェクトには、自動シークレット検出機能が含まれています。

• コミット前フック：コミットのたびに、ステージングされたファイルを自動的にスキャンします
• CI 連携：すべてのプルリクエストでセキュリティチェックを実行します
• パターン検出：AWS キー、GitHub トークン、API キー、秘密鍵などを検出します

詳細はCONTRIBUTING.mdをご覧ください。

プロジェクト構成

src/
├── index.ts        # HTTP server, OAuth proxy, MCP transport
├── client.ts       # API client with request-scoped auth
├── config.ts       # Environment configuration
└── tools/
    ├── debates.ts  # Consultation tools
    └── advisor.ts  # Advisor session tools

貢献

皆さまからの貢献を歓迎します！ガイドラインについては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 - 質問はこちら