🚀 NexusHub

---

✨ 機能

• 📡 デュアルインターフェース - HTTP と stdio の両方の MCP プロトコルに対応
• 💅 モダンダッシュボード - Protocol デザインシステムを採用した美しい管理インターフェース。デフォルトでダークモードです
• 🔌 サービス統合 - 複数の MCP サーバー（Memory、GitHub、Brave Search）を統合
• 🔍 ベクトルデータベース - ドキュメントの取り込みとセマンティック検索に対応
• 🔑 API 管理 - API キーとサービス設定を安全に管理
• 🐳 Docker 統合 - Docker と Docker Compose による簡単なデプロイ
• 📋 高度なプロンプト - 効果的な AI とのやり取りに使える事前設定済みプロンプト
• 🔄 リアルタイムステータス - 接続中のすべてのサービスの稼働状況を監視

🏛️ アーキテクチャ

NexusHub は HTTP インターフェースに Express を使用する Node.js バックエンドと、CLI インターフェース向けのネイティブな stdio 処理を使用します。サーバーは、次の主要なサービスと統合されています。

┌─────────────────────────────────────────────────────┐
│                  Claude Desktop                     │
└───────────┬─────────────────┬───────────┬───────────┘
            │                 │           │
            ▼                 ▼           ▼           
┌───────────────────┐ ┌─────────────┐ ┌─────────────┐ 
│    NexusHub MCP   │ │ Memory MCP  │ │ GitHub MCP  │ 
│       Server      │ │   Server    │ │   Server    │ 
└─────────┬─────────┘ └─────────────┘ └─────────────┘ 
          │                  ▲                ▲        
          ▼                  │                │        
┌─────────────────┐          │                │        
│  Vector Store   │          │                │        
└─────────────────┘          │                │        
          │                  │                │        
          ▼                  │                │        
┌─────────────────┐ ┌─────────────┐ ┌─────────────────┐
│ Filesystem API  │ │ Database API│ │   Docker API    │
└─────────────────┘ └─────────────┘ └─────────────────┘

🛠️ 利用可能なツール

NexusHub は Claude AI に次のツールを提供します。

カテゴリ	ツール	説明
ファイルシステム	fs_list_files	ディレクトリ内のファイルを一覧表示
	fs_read_file	ファイルの内容を読み取る
	fs_write_file	ファイルに書き込む
データベース	db_execute_query	読み取り専用の SQL クエリを実行
	db_list_tables	データベース内のすべてのテーブルを一覧表示
	db_describe_table	テーブルスキーマを取得
	db_insert_data	テーブルにデータを挿入
Docker	docker_list_containers	Docker コンテナを一覧表示
	docker_start_container	コンテナを起動
	docker_stop_container	コンテナを停止
	docker_get_container_logs	コンテナのログを取得
検索	serper_search	Serper API 経由でウェブ検索を実行
ベクトル DB	ingest_docs	ドキュメントをベクトルストアに取り込む
	vector_search	類似ドキュメントを検索

🚀 はじめに

前提条件

• Docker と Docker Compose
• Node.js 18+
• Python 3.8+（ベクトル埋め込み用）

インストール

1. リポジトリをクローンします：

   git clone https://github.com/webdevtodayjason/NexusHub.git
   cd NexusHub
   

2. 環境変数を設定します：

   cp .env.example .env
   # Edit .env file with your API keys
   

3. サービスを起動します：

   docker-compose up -d
   

4. ダッシュボードにアクセスします： ブラウザーで http://localhost:8001/dashboard を開きます

Claude Desktop の設定

NexusHub は Claude Desktop との統合に、次の 2 つの方法をサポートしています。

1. HTTP モード

このモードでは、HTTP エンドポイント経由で NexusHub に接続します。claude_desktop_config.json に次の設定を追加します。

{
  "mcpServers": {
    "nexushub": {
      "name": "NexusHub MCP Server",
      "description": "Centralized MCP server with multiple capabilities",
      "url": "http://localhost:8001/mcp",
      "enabled": true
    }
  }
}

2. STDIO モード（推奨）

このモードでは、パフォーマンスと信頼性を高めるために、プロセス間で直接通信します。NexusHub のコードをローカルで利用できる必要があります。

1. ラッパースクリプトを準備します：

   # Make the wrapper script executable
   chmod +x /path/to/nexushub/nexushub-mcp.sh
   chmod +x /path/to/nexushub/src/mcp/adapters/stdio-wrapper.js
   chmod +x /path/to/nexushub/src/mcp/stdio-adapter.js
   

2. claude_desktop_config.json に追加します：

   {
     "mcpServers": {
       "nexushub": {
         "name": "NexusHub MCP Server",
         "description": "Centralized MCP server with multiple capabilities",
         "command": "/path/to/nexushub/nexushub-mcp.sh",
         "enabled": true
       },
       "brave-search": {
         "name": "Brave Search MCP",
         "description": "Provides web search capabilities via Brave Search API.",
         "command": "docker",
         "args": ["exec", "-i", "mcp_brave_search", "node", "dist/index.js"],
         "enabled": true
       },
       "github": {
         "name": "GitHub MCP",
         "description": "Provides GitHub repository interaction.",
         "command": "docker",
         "args": ["exec", "-i", "mcp_github", "node", "dist/index.js"],
         "enabled": true
       },
       "memory": {
         "name": "Memory MCP",
         "description": "Persistent knowledge graph memory.",
         "command": "docker",
         "args": ["exec", "-i", "mcp_memory", "node", "dist/index.js"],
         "enabled": true
       }
     }
   }
   

注： /path/to/nexushub を、実際の NexusHub のインストールパスに置き換えてください。

Docker コンテナ

Claude Desktop を起動する前に、すべての Docker コンテナが実行中であることを確認してください。

cd /path/to/nexushub
docker-compose up -d

これにより、必要なすべての MCP サーバーが起動します。

• NexusHub（ファイルシステム、データベース、Docker ツールを備えたプライマリサーバー）
• Brave Search MCP（ウェブ検索機能）
• GitHub MCP（リポジトリ操作）
• Memory MCP（ナレッジグラフ／永続メモリ）

💡 使用例

Claude AI で NexusHub を使用する方法をいくつか紹介します。

ファイル操作

Please use fs_list_files to show me all the JavaScript files in the src directory, 
then read the content of any interesting files you find.

データベースクエリ

Can you use db_execute_query to find all users in the database who joined 
in the last month and have the "admin" role?

ベクトル検索

Please use vector_search to find documentation related to "authentication flow" 
and summarize the key points.

ツールの組み合わせ

First, use brave_web_search to find the latest best practices for React error boundaries. 
Then, use fs_read_file to examine our current implementation in ErrorBoundary.jsx, 
and suggest improvements based on what you found.

🧩 独自のツールを追加する方法

/src/mcp/tools/ ディレクトリに新しいツール定義を追加して、NexusHub を拡張できます。

// src/mcp/tools/my-custom-tools.js

export function getToolDefinitions() {
  return {
    my_custom_tool: {
      name: 'my_custom_tool',
      description: 'Description of what the tool does.',
      inputSchema: {
        type: 'object',
        properties: {
          param1: {
            type: 'string',
            description: 'Description of parameter 1'
          }
          // Add more parameters as needed
        },
        required: ['param1']
      }
    }
  };
}

// Tool implementation
export async function myCustomTool(param1) {
  // Your custom tool logic here
  return { result: 'Success!' };
}

次に、/src/mcp/tools/index.js と /src/mcp/tools/handler.js にツールを追加します。

🔄 ローカル開発

1. 依存関係をインストールします：

   npm install
   

2. 開発モードで実行します：

   npm run dev
   

3. stdio モードのテストを行います：

   npm run stdio
   

🧪 テストの実行

# Run all tests
npm test

# Run specific test suite
npm test -- --grep "API Keys"

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

Claude Desktop との連携に関する問題

1. Claude Desktop の起動時に「Unexpected token」エラーが発生する：

   • ラッパースクリプトに適切な権限があることを確認してください：chmod +x nexushub-mcp.sh
   • すべてのスクリプトが JSON 以外の出力を正しくフィルタリングしていることを確認してください。
   • 詳細については、/tmp/nexushub-debug-*.log のログファイルを確認してください。

2. MCP サーバーが読み込まれない、またはツールが表示されない：

   • Docker コンテナが実行中であることを確認してください：docker ps | grep mcp
   • コンテナのログを確認してください：docker logs mcp_brave_search
   • Claude Desktop の設定に正しいパス／コマンドが指定されていることを確認してください。
   • 変更を加えた後、Claude Desktop を再起動してみてください。

3. Docker コンテナに関する問題：

   • Docker のログが大きくなりすぎた場合は、ログを消去してください：docker system prune
   • コンテナを再起動してください：docker-compose restart
   • ポートの競合を確認してください：lsof -i :8001

よくあるエラーメッセージ

エラー	解決策
"Method not found"	MCP サーバーはこのメソッドをサポートしていません。正しいツール名を使用しているか確認してください。
"Socket hang up"	接続の問題です。MCP サーバーが実行中か確認してください。
"ENOENT"	ファイルまたはディレクトリが見つかりません。設定内のパスを確認してください。
"Permission denied"	ファイル権限の問題です。スクリプトの権限を確認してください。
"Unexpected token"	JSON の解析エラーです。MCP サーバーの標準出力を確認してください。

📚 ドキュメント

ツール開発ガイド

• クイックスタートガイド - 5 分で使い始められます
• ツール開発ガイド - ツール作成の包括的なガイド
• AI ツール作成プロンプト - AI を活用したツール作成に最適化されたプロンプト

連携ガイド

• Claude Desktop との連携 - NexusHub を Claude Desktop に接続します
• Claude CLI との連携 - NexusHub を Claude CLI とともに使用します

MCP リソース

• Model Context Protocol 公式サイト
• Claude Desktop ユーザー向け MCP クイックスタート
• Claude Code ドキュメント

ドキュメントの全文は、NexusHub Wikiをご覧ください。

🤝 貢献

オープンソースコミュニティを、学び、刺激を受け、創造するための素晴らしい場にしているのは、皆さまからの貢献です。皆さまからの貢献を心より歓迎します。

1. プロジェクトをフォークします
2. フィーチャーブランチを作成します（git checkout -b feature/AmazingFeature）
3. 変更をコミットします（git commit -m 'Add some AmazingFeature'）
4. ブランチにプッシュします（git push origin feature/AmazingFeature）
5. プルリクエストを作成します

📝 ライセンス

MIT ライセンスの下で配布されています。詳しくは LICENSE をご覧ください。

👨‍💻 作者

Jason Brashear

🙏 謝辞

• Claude AI - 優れた AI 機能を提供してくれたことに感謝します
• Model Context Protocol - プロトコル仕様に感謝します
• Protocol Design System - モダンな UI デザイン言語に感謝します
• Tailwind CSS - ユーティリティファーストの CSS フレームワークに感謝します

---