Enables web search functionality through Brave's search API, allowing AI agents to perform internet searches and retrieve search results.
Provides tools for interacting with GitHub repositories and performing GitHub-related operations.
Enables interaction with Slack workspaces, providing tools for messaging and communication operations.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Search MCP Serversearch for recent pull requests in my GitHub repos"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Search MCP Server
複数のMCPサーバーを統合し、AIクライアントのコンテキスト消費を75%削減するMCPアグリゲーター
Search MCP Serverは、Model Context Protocol (MCP) の理念に基づき、複数のMCPサーバーを1つに集約することで、Claude Desktop、Cursor、Windsurf等のAIクライアントのコンテキスト消費を約75%削減します。
⚡ Bun最適化: 高速なBunランタイムで実装されており、Node.jsと比較して3-4倍高速に動作します。
問題と解決策
現在の課題
Claude Desktop
├── filesystem MCP (50 tools)
├── brave-search MCP (20 tools)
├── database MCP (30 tools)
└── slack MCP (15 tools)
→ 115 tools × 平均200トークン = 23,000トークン消費 😢各MCPサーバーが個別に接続されており、すべてのツールのメタデータが初期読み込み時にコンテキストを消費します。
Search MCPの解決策
Claude Desktop
└── Search MCP (アグリゲーター)
├── filesystem MCP
├── brave-search MCP
├── database MCP
└── slack MCP
→ 軽量メタデータのみ: 約5,750トークン (75%削減!) 🎉Search MCPが複数のMCPサーバーを束ね、プログレッシブな開示により必要な情報だけを段階的に提供します。
主な特徴
🎯 MCPアグリゲーター: 複数のMCPサーバーを1つに統合
📉 コンテキスト削減: 初期読み込みを75%削減（23,000 → 6,000トークン）
🔌 簡単な移行: 既存のClaude Desktop設定をコピペするだけ
🔄 プログレッシブ開示: 必要な情報のみを段階的に取得
🛠️ MCP標準準拠: stdio + JSON-RPC 2.0による標準プロトコル
⚡ 高速: Bunランタイムで3-4倍高速（起動12ms、Node.jsは50ms）
📦 シングルバイナリ: 1つのバイナリファイルで配布可能
🔀 デュアルサポート: Bun（推奨） + Node.js（互換）
クイックスタート
1. インストール
オプション A: Bun を使用（推奨）
# Bunのインストール
curl -fsSL https://bun.sh/install | bash
# リポジトリのクローン
git clone https://github.com/krtw00/search-mcp.git
cd search-mcp
# 依存関係のインストール
bun installオプション B: Node.js を使用
# リポジトリのクローン
git clone https://github.com/krtw00/search-mcp.git
cd search-mcp
# 依存関係のインストール
npm install2. 設定ファイルの作成
既存のClaude Desktop設定からmcpServersセクションをコピー：
mkdir -p config
vi config/mcp-servers.jsonconfig/mcp-servers.json:
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/you/projects"]
},
"brave-search": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-brave-search"],
"env": {
"BRAVE_API_KEY": "${BRAVE_API_KEY}"
}
}
}
}ポイント: Claude Desktopの設定ファイルと全く同じ形式なので、コピペするだけ！
3. Search MCPの起動
開発モード:
# Bunで起動（推奨）
bun run dev
# Node.jsで起動
npm run dev:nodeビルド & 起動:
# Bunでビルド
bun run build
bun start
# Node.jsでビルド
npm run build:node
npm run start:node
# シングルバイナリをビルド（Bun）
bun run build:binary
./search-mcp4. Claude Desktopの設定を更新
変更前 (~/.config/claude/claude_desktop_config.json):
{
"mcpServers": {
"filesystem": { ... },
"brave-search": { ... },
"database": { ... }
}
}変更後（Bun使用）:
{
"mcpServers": {
"search-mcp": {
"command": "bun",
"args": ["run", "/path/to/search-mcp/src/index.ts"],
"env": {
"MCP_CONFIG_PATH": "/path/to/search-mcp/config/mcp-servers.json"
}
}
}
}変更後（シングルバイナリ使用）:
{
"mcpServers": {
"search-mcp": {
"command": "/path/to/search-mcp/search-mcp",
"args": [],
"env": {
"MCP_CONFIG_PATH": "/path/to/search-mcp/config/mcp-servers.json"
}
}
}
}変更後（Node.js使用）:
{
"mcpServers": {
"search-mcp": {
"command": "node",
"args": ["/path/to/search-mcp/dist/index.js"],
"env": {
"MCP_CONFIG_PATH": "/path/to/search-mcp/config/mcp-servers.json"
}
}
}
}5. Claude Desktopを再起動
完了！これでSearch MCP経由ですべてのツールが使えるようになり、コンテキスト消費が大幅に削減されます。
コンテキスト削減の仕組み
段階的な情報取得
初期読み込み（軽量）
ツール名とサーバー名のみ返す
115 tools × 50トークン = 5,750トークン
詳細取得（必要時のみ）
詳細なパラメータ情報を返す
1 tool × 200トークン = 200トークン
実行
ツールを実行し、結果を返す
合計: 約6,000トークン (従来の23,000トークンから75%削減)
プロジェクト構成
search-mcp/
├── src/
│ ├── mcp/
│ │ ├── mcp-client-manager.ts # MCP統合管理
│ │ └── mcp-client.ts # 個別MCP接続
│ ├── index.ts # MCPサーバー実装
│ ├── tool-registry.ts # ツール集約
│ └── types.ts # 型定義
├── config/
│ └── mcp-servers.json # MCP設定ファイル
├── docs/
│ ├── design/ # 詳細設計
│ │ ├── 07-simplified-setup.md
│ │ └── 08-mcp-aggregator.md
│ ├── architecture.md
│ └── mcp-concepts.md
└── package.jsonMCPプロトコル対応
Search MCPは、Model Context Protocolの標準仕様に準拠しています：
✅ stdio通信: 標準入出力を使用した通信
✅ ツール発見:
tools/listメソッド✅ ツール実行:
tools/callメソッド✅ 初期化:
initializeプロトコル🔜 SSE (Server-Sent Events): 今後対応予定
🔜 リソース管理: 今後対応予定
対応MCPサーバー
以下を含む、すべての標準MCP準拠サーバーに対応：
その他、MCPプロトコルを実装したすべてのサーバー
ドキュメント
ユーザー向け
開発者向け
MCPアグリゲーター設計 - 内部設計の詳細
アーキテクチャ - システムアーキテクチャ
設計ドキュメント - 詳細な実装設計
ロードマップ
Phase 1: MCPアグリゲーター基本実装
Phase 2: 検索機能強化
Phase 3: セキュリティ機能（認証・レート制限）
Phase 4: 動的MCPサーバー登録
Phase 5: Web管理UI（オプション）
詳細は docs/design/00-overview.md を参照。
技術スタック
ランタイム: Bun 1.0+ （推奨）/ Node.js 18+ （互換）
言語: TypeScript 5.9+
プロトコル: MCP (Model Context Protocol)
通信: stdio + JSON-RPC 2.0
プロセス管理: child_process.spawn
依存関係: @modelcontextprotocol/sdk（オプション）
なぜBun？
⚡ 3-4倍高速: Node.jsと比較して圧倒的なパフォーマンス
🪶 30%軽量: メモリ使用量が少ない（20-30MB vs 30-50MB）
🚀 起動が速い: 12ms（Node.jsは50ms）
📦 シングルバイナリ: ランタイム不要の配布が可能
🔧 TypeScript標準: トランスパイル不要で直接実行
✅ Claude Code採用: AnthropicがBunでMCPを実装（互換性保証）
詳細は docs/design/tech-stack-bun-deep-dive.md を参照。
開発
開発モード
# Bunで開発（推奨）
bun run dev
# Node.jsで開発
npm run dev:nodeテスト
# Bunでテスト
bun test
# Node.jsでテスト
npm run test:nodeビルド
# Bunでビルド
bun run build
# シングルバイナリ作成
bun run build:binary
# Node.jsでビルド
npm run build:node詳細な実装ガイドは IMPLEMENTATION.md を参照。
トラブルシューティング
MCPサーバーに接続できない
# 詳細ログを有効化
LOG_LEVEL=debug npm start
# 設定を確認
cat config/mcp-servers.json環境変数が読み込まれない
# 環境変数を設定
export BRAVE_API_KEY="your-api-key"
# または.envファイルを使用
echo "BRAVE_API_KEY=your-api-key" > .envライセンス
MIT
貢献
プルリクエストを歓迎します。大きな変更の場合は、まずissueを開いて変更内容を議論してください。