mcpField
S
simple_mcp

simple_mcp

ローカル
github.com/oleksii-donets開発ツール024 週間前に更新
リポジトリ

simple_mcp について

simple_mcpは、テストや実験向けの小規模なPython製MCPサーバーです。ランダム値を返すツールを1つ備え、STDIO、HTTP、SSEの各トランスポートに対応します。

主な機能

  1. 01ランダム浮動小数点ツール
  2. 02STDIOトランスポート
  3. 03HTTPトランスポート
  4. 04SSEトランスポート
  5. 05Dockerでの実行

活用シーン

  1. 01MCPクライアント接続のテスト
  2. 02トランスポート方式の実験
  3. 03Dockerで小規模サーバーを実行

MCP 対応

MCPクライアントに、[0,1)のランダム値を返す`random_float`ツールを提供します。STDIO、HTTP、SSEの各トランスポートに対応します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "oleksii-donets-simple": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "APP_TRANSPORT",
        "-e",
        "APP_HOST",
        "-e",
        "APP_PORT",
        "docker.io/d0nets/simple-mcp:0.0.4"
      ],
      "env": {
        "APP_TRANSPORT": "<APP_TRANSPORT>",
        "APP_HOST": "<APP_HOST>",
        "APP_PORT": "<APP_PORT>"
      }
    }
  }
}
起動コマンドdocker run -i --rm -e APP_TRANSPORT -e APP_HOST -e APP_PORT docker.io/d0nets/simple-mcp:0.0.4
設定が必要な環境変数
APP_TRANSPORTTransport type
APP_HOSTServer host
APP_PORTServer port

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
ocidocker.io/d0nets/simple-mcp:0.0.4

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

シンプルな MCP サーバー（Python）

このプロジェクトでは、Python を使用した最小限の Model Context Protocol（MCP）サーバーを提供します。0 以上 1 未満のランダムな浮動小数点数を返す単一のツール random_float を公開します。サーバーは、STDIO（デフォルト）、HTTP、SSE の複数のトランスポートモードに対応しています。

ローカルで実行

デフォルト（STDIO トランスポート）
uv run main.py

サーバー環境変数

変数用途デフォルト
APP_TRANSPORTトランスポートの種類（STDIO、HTTP、SSE）STDIO
APP_HOSTサーバーのホスト0.0.0.0
APP_PORTサーバーのポート8000

Docker

イメージをビルドして実行します：

docker build -t simple-mcp .
トランスポートを変更して Docker を実行
# HTTP transport
docker run --rm -p 8000:8000 -e APP_TRANSPORT=HTTP simple-mcp

# SSE transport
docker run --rm -p 8000:8000 -e APP_TRANSPORT=SSE simple-mcp

# Custom port
docker run --rm -p 9000:9000 -e APP_TRANSPORT=HTTP -e APP_PORT=9000 simple-mcp

スタンドアロンアプリとしてテスト

Postman を使用してテスト
uv --directory <path_to_project_directory> run main.py
Claude Desktop を使用してテスト
{
  "mcpServers": {
    "simple_mcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "<path_to_project_directory>",
        "main.py"
      ]
    }
  }
}

Docker イメージとしてテスト

Postman を使用してテスト
docker run --rm -i simple-mcp
Claude Desktop を使用してテスト
{
  "mcpServers": {
    "simple_mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "simple-mcp"
      ]
    }
  }
}

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。