Custom MCP Server

カスタム MCP サーバー

AI アシスタント向けにさまざまなツールを統合する、カスタムの Machine Conversation Protocol（MCP）サーバーです。

• Brave Search - ウェブ検索とローカル検索機能
• セキュアなファイルシステム - セキュリティ制御を備えたファイル操作
• GitHub 連携 - リポジトリとコードの管理
• Sequential Thinking - 段階的な問題解決
• ダウンロードユーティリティ - インターネットからのファイルのダウンロード

クイックスタート

# Clone the repository
git clone https://github.com/degenhero/custom-mcp-server.git
cd custom-mcp-server

# Install dependencies and set up environment
npm run install:all

# Start both servers
npm run start:both

サーバーは次の場所で実行されます。

• MCP サーバー：http://localhost:3000
• MCP プロトコルサーバー：http://localhost:3001

Claude での使用方法

このカスタム MCP サーバーを Claude で使用するには、MCP サーバーとしてインストールする必要があります。

npx @anthropic-ai/install-mcp custom-mcp-server http://localhost:3001

インストール後、Claude はこのサーバーが提供するすべての関数を利用できるようになります。

アーキテクチャ

このプロジェクトは、次の 2 つの主要コンポーネントで構成されています。

1. カスタム MCP サーバー（index.js） - すべてのツール関数を実装する中核サーバー
2. MCP プロトコルサーバー（mcp-protocol.js） - カスタムサーバーを MCP プロトコル標準に適合させます

利用可能な関数

Brave Search

• brave_web_search - ウェブ検索を実行します
• brave_local_search - 地元の店舗や場所を検索します

ファイルシステム操作

• read_file - ファイルの内容を読み込みます
• write_file - ファイルを作成または更新します
• edit_file - 行単位で編集します
• create_directory - ディレクトリを作成します
• list_directory - ディレクトリの内容を一覧表示します
• その他...

GitHub 連携

• create_repository - 新しいリポジトリを作成します
• search_repositories - リポジトリを検索します
• get_file_contents - リポジトリ内のファイルを読み込みます
• push_files - リポジトリにファイルをプッシュします
• その他...

Sequential Thinking

• sequentialthinking - 段階的に問題を解決します

ダウンロードユーティリティ

• download_file - URL からファイルをダウンロードします
• download_multiple_files - 複数のファイルを一度にダウンロードします

設定

設定は、.env ファイル内の環境変数で管理します。

PORT=3000                      # Port for the main server
MCP_PROTOCOL_PORT=3001         # Port for the MCP protocol server
BRAVE_API_KEY=your_key_here    # API key for Brave Search
GITHUB_TOKEN=your_token_here   # GitHub access token

開発

新しい関数の追加

新しい関数を追加するには、次の手順に従います。

1. functions ディレクトリ内の適切なファイルにハンドラーを作成します
2. mcp-schema.json に関数定義を追加します
3. index.js のルーティングを更新します

テスト

MCP サーバーに対して関数を直接テストできます。

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{"functionName": "brave_web_search", "parameters": {"query": "test query"}}'

ドキュメント

利用可能なすべての関数の詳細については、documentation.md を参照してください。

ライセンス

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