Nexus

🚀 🔍 Nexus MCP Server

Nexus MCP Serverは、複雑さを伴わずにAIを統合することができる、本番環境でも使用可能なサーバです。このサーバを使用することで、開発環境に直接AIによるウェブ検索機能を導入することができます。

インストール不要で簡単に使える、AIによるインテリジェントなモデル検索と発見

クイックスタート • 主な機能 • ドキュメント • コントリビュート

🚀 クイックスタート

前提条件

• Node.js 16以上
• OpenRouter APIキー（OpenRouterで取得）

ゼロコンフィグレーションインストール

ビルド手順や依存関係、セットアップは必要ありません。以下のコマンドを実行するだけです。

# OpenRouter APIキーを設定
export OPENROUTER_API_KEY=your-api-key-here

# サーバを即座に起動
npx nexus-mcp

これでサーバが起動し、MCPクライアントからの接続を待機しています。

NPXインストールのテスト

# CLIヘルプをテスト
npx nexus-mcp --help

# バージョンをテスト
npx nexus-mcp --version

# APIキーを指定して実行
OPENROUTER_API_KEY=your-key npx nexus-mcp

代替方法：ローカル開発用インストール

ローカル開発やカスタマイズのためには、以下の手順を実行します。

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

git clone https://github.com/adawalli/nexus.git
cd nexus

2. 依存関係をインストールします。

npm install

3. サーバをビルドします。

npm run build

4. OpenRouter APIキーを設定します。

# 環境ファイルのサンプルをコピー
cp .env.example .env

# .envを編集し、実際のAPIキーを追加
# OPENROUTER_API_KEY=your-api-key-here

5. サーバをテストします。

npm start

MCPクライアントとの統合

🚀 NPXを使用したクイックセットアップ（推奨）

NPXを使用すると、任意のMCPクライアントと簡単に統合できます。

Claude Code

Claude CodeのMCP設定にこのサーバを追加します。

1. MCP設定ファイル（通常は~/.claude/mcp_settings.json）を開きます。
2. NPXを使用してサーバ構成を追加します。

{
  "mcpServers": {
    "nexus": {
      "command": "npx",
      "args": ["nexus-mcp"],
      "env": {
        "OPENROUTER_API_KEY": "your-api-key-here"
      }
    }
  }
}

3. Claude Codeを再起動します。

Cursor

CursorのMCP設定でサーバを構成します。

1. Cursorの設定を開き、MCPサーバに移動します。
2. 新しいサーバを追加します。
   • 名前: nexus
   • コマンド: npx
   • 引数: ["nexus-mcp"]
   • 環境変数:
     • OPENROUTER_API_KEY: your-api-key-here
3. Cursorを再起動します。

その他のMCPクライアント

MCP互換のクライアントでは、以下の接続詳細を使用します。

• トランスポート: stdio
• コマンド: npx
• 引数: ["nexus-mcp"]
• 環境変数: OPENROUTER_API_KEY=your-api-key-here

代替方法：ローカルインストール

ローカルインストールを使用する場合は（ローカル開発セットアップを行った後）、以下の構成を使用します。

{
  "mcpServers": {
    "nexus": {
      "command": "node",
      "args": ["/path/to/nexus-mcp/dist/cli.js"],
      "env": {
        "OPENROUTER_API_KEY": "your-api-key-here"
      }
    }
  }
}

✨ 主な機能

🚀 インストール不要の簡便さ

• npxで30秒で使用可能
• 依存関係やビルド手順が不要
• クロスプラットフォーム互換性
• 常に最新版

🧠 AIによるインテリジェントな検索

• Perplexity Sonarモデルを統合
• リアルタイムのウェブコンテンツ検索
• コンテキストを考慮した結果のランキング
• 複数のモデルオプション

📚 高品質な検索結果

• 出典引用とメタデータ
• 包括的なエラーハンドリング
• 本番環境での信頼性
• TypeScriptによる実装

🔧 開発者向けの機能

• MCPプロトコル準拠
• 充実したドキュメント
• 設定可能なパラメータ
• コミュニティサポート

💻 使用例

基本的な使用法

検索ツールを使用して、「AIの最新の開発動向」に関する情報を検索します。

高度な使用法

以下のパラメータを使用して、「気候変動対策」を検索します。
- モデル: perplexity/sonar
- 最大トークン数: 2000
- 温度: 0.3

📚 ドキュメント

利用可能なツール

search

AIによるウェブ検索機能を提供する主要な検索ツールです。

パラメータ:

• query (必須): 検索クエリ（1 - 2000文字）
• model (オプション): 使用するPerplexityモデル（デフォルト: "perplexity/sonar"）
• maxTokens (オプション): 最大応答トークン数（1 - 4000、デフォルト: 1000）
• temperature (オプション): 応答のランダム性（0 - 2、デフォルト: 0.7）

応答例:

現在の情報に基づいて、AIの最新の開発動向は以下の通りです...

[最新情報を含む詳細なAI生成応答]

---
**検索メタデータ:**
- モデル: perplexity/sonar
- 応答時間: 1250ms
- 使用トークン数: 850
- 出典: 5件発見

設定

環境変数

• OPENROUTER_API_KEY (必須): あなたのOpenRouter APIキー
• NODE_ENV (オプション): 環境設定（開発、本番、テスト）
• LOG_LEVEL (オプション): ログレベル（デバッグ、情報、警告、エラー）

高度な設定

サーバは環境変数を通じて追加の設定をサポートしています。

• OPENROUTER_TIMEOUT_MS: リクエストのタイムアウト時間（ミリ秒）（デフォルト: 30000）
• OPENROUTER_MAX_RETRIES: 最大リトライ回数（デフォルト: 3）
• OPENROUTER_BASE_URL: カスタムOpenRouter APIベースURL

リソース

サーバはconfig://statusに構成ステータスリソースを提供しており、以下の情報を表示します。

• サーバのヘルスステータス
• 構成情報（APIキーはマスクされています）
• 検索ツールの可用性
• サーバの稼働時間とバージョン

トラブルシューティング

NPX固有の問題

• "npx: command not found"
  • Node.js 16以上がインストールされていることを確認します: node --version
  • npmを更新します: npm install -g npm@latest
• "Cannot find package 'nexus-mcp'"
  • パッケージがまだ公開されていない可能性があります。代わりにローカルインストールを使用してください。
  • npmレジストリへのネットワーク接続を確認してください。
• NPXが起動に時間がかかる
  • 初回実行時はNPXがパッケージをダウンロードするため、これは正常です。
  • キャッシュにより、以降の実行は高速になります。
  • より高速な起動を望む場合は、代わりにローカルインストールを使用してください。
• "Permission denied"エラー
  • 試してみてください: npx --yes nexus-mcp --stdio
  • またはnpmのパーミッションを設定します: npm config set user 0 && npm config set unsafe-perm true

一般的な問題

• "Search functionality is not available"
  • OPENROUTER_API_KEY環境変数が設定されていることを確認します。
  • OpenRouterでAPIキーが有効であることを確認します。
  • サーバのログで初期化エラーを確認します。
• "Authentication failed: Invalid API key"
  • APIキーの形式と有効性を再度確認します。
  • キーに十分なクレジット/権限があることを確認します。
  • OpenRouterダッシュボードでキーを直接テストします。
• "Rate limit exceeded"
  • レート制限がリセットされるまで待ちます（通常は1分）。
  • より高い制限のOpenRouterプランにアップグレードを検討します。
  • OpenRouterダッシュボードで使用量を監視します。
• 接続タイムアウト
  • インターネット接続を確認します。
  • サーバは失敗したリクエストを自動的に再試行します。
  • 必要に応じてタイムアウトを増やします: OPENROUTER_TIMEOUT_MS=60000
• MCPクライアントがサーバに接続できない
  • MCP構成が正しいコマンドと引数を使用していることを確認します。
  • MCPクライアントの環境でNode.js 16以上が利用可能であることを確認します。
  • 環境変数にAPIキーが正しく設定されていることを確認します。

デバッグログ

デバッグログを有効にするには、以下の手順を実行します。

• ローカル開発の場合: .envファイルにLOG_LEVEL=debugを追加します。
• MCPクライアントの場合: MCP構成のenvセクションにLOG_LEVEL: "debug"を追加します。

これにより、以下の詳細情報が提供されます。

• 構成の読み込み
• APIリクエストと応答
• エラーの詳細とスタックトレース
• パフォーマンスメトリクス

接続テスト

MCPクライアントで構成ステータスリソースを確認するか、簡単な検索クエリを実行することで、サーバが正常に動作しているかをテストできます。

開発

このサーバに取り組む開発者向けに、以下のコマンドが用意されています。

# ホットリロードで開発
npm run dev

# テストを実行
npm test

# カバレッジ付きでテストを実行
npm run test:coverage

# コードをリント
npm run lint

# コードをフォーマット
npm run format

💰 APIクレジットとコスト

このサーバはOpenRouterのAPIを使用しており、トークンの使用量に基づいて課金されます。

• Perplexity Sonarモデル: OpenRouter Modelsで現在の価格を確認してください。
• 使用量の監視: OpenRouterダッシュボードを通じて消費量を追跡します。
• コストコントロール: OpenRouterアカウントで使用制限を設定します。
• 最適化: Nexusには組み込みのレート制限とインテリジェントなキャッシュが含まれています。

関連プロジェクト

• Model Context Protocol - 当サーバが実装している標準
• OpenRouter - AIモデルのプロバイダ
• Claude Desktop - 主要なMCPクライアント
• Cursor - MCPサポートを備えたAIコードエディタ

サポートとコミュニティ

🤝 コントリビュート

私たちは、あらゆる経験レベルの開発者からのコントリビューションを歓迎します！

🚀 始めるには

• リポジトリをフォークします。
• Contributing Guideを読みます。
• good first issuesを確認します。

🐛 問題の報告

• Bug Reports
• Feature Requests
• Ask Questions

💬 コミュニティに参加する

• GitHub Discussions
• Code of Conduct
• Roadmap & Project Board

🌟 貢献者への認識

貢献者は以下の場所で認識されます。

• Contributors list
• 重要な貢献に対するリリースノート
• コミュニティのスポットライトと証言

📄 ライセンス

MIT License - 詳細はLICENSEファイルを参照してください。