Custom MCP Server

🚀 カスタムMCPサーバー

このカスタムマシン対話プロトコル（MCP）サーバーは、AIアシスタント向けに複数のツールを統合しています。以下の機能を提供します。

• Brave検索 - ウェブとローカルの検索機能
• セキュアなファイルシステム - セキュリティ制御付きのファイル操作
• GitHub統合 - リポジトリとコードの管理
• 順序思考 - 段階的に問題を解決
• ダウンロードツール - インターネットからのファイルダウンロード

🚀 クイックスタート

# リポジトリをクローン
git clone https://github.com/degenhero/custom-mcp-server.git
cd custom-mcp-server

# 依存関係をインストールし、環境を設定
npm run install:all

# 2つのサーバーを起動
npm run start:both

サーバーは以下のアドレスで実行されます。

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

💻 使用例

基本的な使用法

ClaudeとこのカスタムMCPサーバーを連携させるには、以下のコマンドで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検索

• 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 - ファイルをリポジトリにプッシュ
• など...

順序思考

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

ダウンロードツール

• download_file - URLからファイルをダウンロード
• download_multiple_files - 複数のファイルを同時にダウンロード

設定

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

PORT=3000                      # メインサーバーのポート
MCP_PROTOCOL_PORT=3001         # MCPプロトコルサーバーのポート
BRAVE_API_KEY=your_key_here    # Brave検索のAPIキー
GITHUB_TOKEN=your_token_here   # GitHubアクセストークン

開発

新機能の追加

新しい機能を追加するには、以下の手順を実行します。

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 ファイルを参照してください。