Simple MCP Server

🚀 シンプルなMCPサーバー

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

🚀 クイックスタート

このセクションでは、簡単にMCPサーバーを起動する手順を説明します。

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

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

Dockerイメージの構築

以下のコマンドを使用して、提供された Dockerfile からMCPサーバーのDockerイメージを構築します。

docker compose build

コンテナの起動

構築したイメージを使って、コンテナをデタッチモードで起動します。

docker compose up -d

このコマンドは以下の操作を行います：

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

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

docker compose down

✨ 主な機能

• SSEを通じてカスタムツールをMCPエンドポイントとして公開し、イベントをプッシュする
• Docker Composeを使用したコンテナ化されたデプロイメントで、迅速な起動と実行が可能
• ポートとホストを設定可能
• 天気警報や予報などのサンプルツールが含まれている

📦 インストール

このプロジェクトを動作させるには、以下の前提条件を満たす必要があります。

💻 使用例

基本的な使用法

MCPクライアントの接続

MCP互換クライアント（例：Claudeデスクトップ版）を設定して、SSEを介して次のURLに接続します。

http://localhost:8100/sse

docs フォルダには、Claudeデスクトップと互換性のある簡単な設定ファイル（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とプロトコルバージョンが正しく設定されていることを確認してください。

📄 ライセンス

このプロジェクトのライセンスに関する詳細情報は、リポジトリ内のライセンスファイルを参照してください。