Nexus-MCP

AIアシスタントのための包括的なModel Context Protocolツールキット

あらゆるAIアシスタントを、現実世界のタスクを実行可能な自律型エージェントに変革します。

ドキュメント • はじめに • ロードマップ • アーキテクチャ

🎯 概要

Nexus-MCPは、TypeScript/Node.jsで構築された強力なModel Context Protocol (MCP) サーバーであり、AIモデルに以下のための汎用ツールを提供します。

• 📁 ファイルシステム操作 - ファイルの読み取り、書き込み、検索、監視

• 🌐 HTTP/Webリクエスト - データの取得、Webサイトのスクレイピング、APIの呼び出し

• 🔄 Gitワークフロー - クローン、コミット、ブランチ、リポジトリ管理

• 🗄️ データベースクエリ - SQLおよびNoSQLデータベースへのクエリ

• 💻 システムコマンド - シェルコマンドの実行とプロセス管理

• 🤖 AI統合 - LLMとのチャット、埋め込み作成、テキスト処理

• 🔧 ユーティリティ - JSON/YAML解析、圧縮、暗号化など

🚀 クイックスタート

インストール

npm install -g @nexus-mcp/server

設定

# Copy example environment file
cp .env.example .env

# Edit with your settings
nano .env

実行

nexus-mcp

Claude Codeとの統合

Claude Desktopの設定に追加します：

{
  "mcpServers": {
    "nexus-mcp": {
      "command": "node",
      "args": ["/path/to/nexus-mcp/dist/index.js"]
    }
  }
}

📦 機能

ファイルシステムツール

• nexus_read_file - エンコーディング対応のファイル読み取り

• nexus_write_file - ファイルの書き込み/作成

• nexus_list_directory - ディレクトリ内容の一覧表示

• nexus_search_files - パターンによるファイル検索

• nexus_search_content - ファイル内のコンテンツ検索

• nexus_watch_directory - ディレクトリ変更の監視

HTTPツール

• nexus_http_get - HTTP GETリクエスト

• nexus_http_post - HTTP POSTリクエスト

• nexus_fetch_url - Webコンテンツの取得と解析

• nexus_parse_html - Cheerioを使用したHTML解析

• nexus_call_api - 汎用API呼び出し

Gitツール

• nexus_git_clone - リポジトリのクローン

• nexus_git_commit - コミットの作成

• nexus_git_push - リモートへのプッシュ

• nexus_git_pr_create - プルリクエストの作成

• GitHub、GitLab、Bitbucketとの統合

データベースツール

• nexus_db_query - SQLクエリの実行

• nexus_db_list_tables - データベーステーブルの一覧表示

• nexus_db_describe_table - テーブルスキーマの記述

• PostgreSQL、MySQL、SQLite、SQL Server、MongoDBをサポート

システムツール

• nexus_exec_command - シェルコマンドの実行

• nexus_system_info - システム情報の取得

• nexus_process_list - 実行中プロセスの一覧表示

• nexus_service_start/stop - サービスの管理

AIツール

• nexus_llm_chat - LLMとのチャット (Anthropic, OpenAI)

• nexus_embedding_create - テキスト埋め込みの作成

• nexus_text_summarize - テキストの要約

• nexus_code_generate - コード生成

ユーティリティツール

• nexus_json_parse/stringify - JSON操作

• nexus_yaml_parse/stringify - YAML操作

• nexus_zip_create/extract - ZIP圧縮

• nexus_encrypt/decrypt - 暗号化/復号化

🏗️ アーキテクチャ

┌─────────────────────────────────────────┐
│         Claude / LLM Client              │
└──────────────┬──────────────────────────┘
               │ MCP Protocol (stdio)
               ▼
┌─────────────────────────────────────────┐
│           Nexus-MCP Server               │
│  ┌───────────────────────────────────┐  │
│  │      MCP Server Core             │  │
│  └───────────────────────────────────┘  │
│         ┌───────┴───────┐                │
│         │               │                │
│    ┌────▼────┐    ┌────▼────┐           │
│    │ Filesys │    │   HTTP  │           │
│    └─────────┘    └─────────┘           │
│    ┌─────────┐    ┌─────────┐           │
│    │   Git   │    │ Database│           │
│    └─────────┘    └─────────┘           │
│    ┌─────────┐    ┌─────────┐           │
│    │  System │    │    AI   │           │
│    └─────────┘    └─────────┘           │
└─────────────────────────────────────────┘

詳細なアーキテクチャについては、docs/architecture.mdを参照してください。

🏛️ プロダクション品質

Nexus-MCPはアーキテクチャの卓越性を念頭に置いて構築されており、本番環境での使用とコミュニティでの採用を想定しています。私たちは厳格な原則に従っています：

• ✅ 型安全性: TypeScriptの厳格モード + Zodバリデーション

• ✅ エラーハンドリング: 構造化された実用的なエラーメッセージ

• ✅ パフォーマンス: 非同期操作、キャッシュ、ストリーミング

• ✅ セキュリティ: 入力バリデーション、サニタイズ、監査ログ

• ✅ 可観測性: 構造化ログ、メトリクス、トレーシング

• ✅ テスト容易性: 80%以上のカバレッジ、依存性の注入

• ✅ ドキュメント: JSDoc、例、包括的なガイド

• ✅ 開発者体験: 明確なエラー、IDEサポート、迅速なフィードバック

詳細はアーキテクチャ原則を参照してください。

📚 ドキュメント

• はじめにガイド - クイックスタートと基本的な使用方法

• アーキテクチャドキュメント - システムアーキテクチャと設計

• アーキテクチャ原則 - 設計原則とベストプラクティス

• APIリファレンス - 完全なAPIドキュメント

• ツールリファレンス - 詳細なツールドキュメント

• ロードマップ - 開発ロードマップと進捗状況

🛠️ 開発

# Clone repository
git clone https://github.com/your-org/Nexus-MCP.git
cd Nexus-MCP

# Install dependencies
npm install

# Run in development mode
npm run dev

# Run tests
npm test

# Build for production
npm run build

# Lint code
npm run lint

📊 プロジェクトステータス

• 現在のバージョン: 1.0.0-alpha

• 開発ステータス: 計画・設計

• コア進捗: 0%

• ターゲットツール数: 50以上

• テストカバレッジ目標: 80%以上

詳細な進捗についてはROADMAP.mdを参照してください。

🤝 貢献

貢献を歓迎します！プルリクエストを送信する前に、貢献ガイドラインをお読みください。

1. リポジトリをフォークする

2. フィーチャーブランチを作成する (git checkout -b feature/amazing-feature)

3. 変更をコミットする (git commit -m 'Add amazing feature')

4. ブランチにプッシュする (git push origin feature/amazing-feature)

5. プルリクエストを開く

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細はLICENSEファイルを参照してください。

🙏 謝辞

• Model Context Protocol

• Anthropic Claude

• MCP SDK TypeScript

📞 サポート

• 📖 ドキュメント

• 🐛 Issueトラッカー

• 💬 Discordコミュニティ

• ✉️ メール: support@nexus-mcp.dev

Built with ❤️ by the Nexus Team