Fast MCP Server

🚀 高速MCPサーバー

このサーバーは軽量なMCP（モデルコンテキストプロトコル）サーバーの実装で、SSEインターフェースを通じてカスタムツールを公開し、AIクライアントとの統合を可能にします。

🚀 クイックスタート

このリポジトリは、簡単なMCPサーバーを提供しています。カスタムツール（天気警報や予報など）を実装し、SSEインターフェースを通じて公開することができます。Dockerコンテナを使用することで、迅速にデプロイでき、MCPプロトコルに対応したクライアントとシームレスに統合することが可能です。

✨ 主な機能

• SSEインターフェースを通じて、カスタムツールをMCPエンドポイントとして公開する
• Docker Composeを使用したコンテナ化により、迅速なデプロイを容易にする
• ポートとホストアドレスを設定可能
• サンプルツール（天気警報や予報など）を含む

📦 インストール

前提条件

• Docker ≥ 20.10
• Docker Compose ≥ 1.29

クイックスタート

リポジトリをクローンし、プロジェクトディレクトリに移動します。

git clone git@github.com:kongo97/fast-mcp-server.git
cd fast-mcp-server

Dockerイメージのビルド

docker compose build

このコマンドは、提供されている Dockerfile を使用して、MCPサーバーのDockerイメージをビルドします。

コンテナの起動

docker compose up -d

このコマンドは以下のことを行います。

• イメージを取得/ビルドする
• デタッチモードでコンテナを起動する
• ホストのポート 8100 をコンテナのポート 8100 にマッピングする

コンテナを停止して削除するには、以下のコマンドを実行します。

docker compose down

💻 使用例

MCPクライアントの接続

MCP互換クライアント（Claude Desktopなど）を構成し、SSEインターフェースを通じて以下のアドレスに接続します。

http://localhost:8100/sse

docsフォルダには、Claude Desktopで使用するための簡単な構成例（claude_desktop_config.json）があります。

利用可能なエンドポイント

📚 ドキュメント

設定

docker-compose.yml で、またはコンテナ内で直接環境変数を設定することで、サーバーのポートとホストアドレスをカスタマイズすることができます。

services:
  mcp-server:
    environment:
      - MCP_PORT=8100         # デフォルトポート
      - MCP_HOST=0.0.0.0      # バインドアドレス

開発

1. src/server.py（または任意のファイル）でMCPツールを編集または追加します。
2. コンテナを再構築して再起動します。

   docker compose build
   docker compose up -d
   

3. ログを確認してエラー情報を取得します。

   docker compose logs -f
   

トラブルシューティング

• /sse へのアクセスで404が返される場合：サーバーが正しいポートとパスにバインドされていることを確認してください。
• 接続が拒否される場合：Dockerが実行中で、コンテナの状態が正常であることを確認してください。

  docker ps
  docker logs simple-mcp-server
  

• クライアントエラーの場合：クライアント設定のSSE URLとプロトコルバージョンが正しいことを確認してください。

📄 ライセンス

具体的なライセンス情報は、元のREADMEに記載がないため、ここでは省略しています。