Fast MCP Server

Fast MCP Server

AI クライアントとの連携に向けて、SSE 経由でカスタムツールを公開する軽量な MCP（Model Context Protocol）サーバーの実装です。

目次

• 概要
• 機能
• 前提条件
• はじめに
  • Docker イメージをビルドする
  • コンテナを起動する
• 使い方
  • MCP クライアントの接続
  • 利用可能なエンドポイント
• 設定
• 開発
• トラブルシューティング
• ライセンス

概要

このリポジトリでは、カスタムツール（例：天気情報の検索）を実装し、Server-Sent Events（SSE）経由で公開するシンプルな MCP サーバーを提供します。Docker コンテナで実行できるため、すばやくデプロイでき、MCP プロトコルに対応したクライアントとシームレスに連携します。

機能

• SSE 経由でツールを MCP エンドポイントとして公開
• Docker Compose を使って簡単にデプロイできるコンテナ化
• ポートとホストを設定可能
• サンプルツールを同梱（例：気象警報と天気予報）

前提条件

• Docker ≥ 20.10
• Docker Compose ≥ 1.29

はじめに

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

git clone [email protected]:kongo97/fast-mcp-server.git
cd fast-mcp-server

Docker イメージをビルドする

docker compose build

これにより、付属の Dockerfile を使って MCP サーバーのイメージがビルドされます。

コンテナを起動する

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）があります。

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

メソッド	パス	説明
GET	/sse	MCP 通信の SSE ストリームを開きます
POST	/sse	SSE 経由で JSON-RPC リクエストを送信します

設定

docker-compose.yml で環境変数を設定するか、コンテナ内で直接設定することで、サーバーのポートとホストを変更できます。

services:
  mcp-server:
    environment:
      - MCP_PORT=8100         # default port
      - MCP_HOST=0.0.0.0      # bind address

開発

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 とプロトコルのバージョンが正しく設定されていることを、クライアントの設定で確認してください。