Simple MCP Client Server

🚀 シンプルなMCPクライアント/サーバ

このプロジェクトは、簡単に使えるMCP（Model Context Protocol）のクライアントとサーバを提供します。MCPを使って、モデルとのやり取りを効率的に行うことができます。

MCPのクイックスタートガイド

🚀 クイックスタート

前提条件

macOSとLinuxでは、uvをインストールする必要があります。

$ curl -LsSf https://astral.sh/uv/install.sh | sh

リポジトリのクローン

インストールが完了したら、リポジトリをクローンします。

✨ 主な機能

📦 MCPサーバ（標準入出力）

サーバのセットアップ

uv init mcp_server
cd mcp_server/
uv run main.py                        # .venv環境を作成し、main.pyファイルを削除します

uv add "mcp[cli]" httpx               # MCPサーバのPythonライブラリを追加します

touch weather_stdio.py                # 標準入出力サーバの実装ファイルを作成します

サーバの起動

mcp_server$ uv run weather_stdio.py

VSCode + Clineでのテスト

MCPサーバをClineに追加します。

Cline -> MCPサーバ（'+'の近くのアイコン）-> インストール済み -> 追加

JSONテンプレート "mcpServers": {} が表示されるので、新しいサーバを追加します。以下は cline_mcp_settings.json の例です。

{
  "mcpServers": {
    "weather": {
            "command": "uv",
            "args": [
                "--directory",
                "/home/users/tikoehle/mcp_server",
                "run",
                "weather_stdio.py"
            ]
        }
  }
}

Clineには2つの get_* ツール関数が表示されます。'完了' をクリックしてClineのタスク入力画面に戻り、新しいサーバを試してみましょう。

テスト

以下のようなタスクを入力して、2つのツールを呼び出します。 "Can you tell me the weather forecast for San Francisco, CA" "Can you tell me the weather alerts for San Francisco, CA"

これで、新しいMCP 'weather' サーバツールを使用できます。

⚠️ 重要提示

ローカル開発のMCPサーバは、標準出力にメッセージを出力しないでください。これは、プロトコルの操作に干渉する可能性があります。

📦 MCPクライアント

MCPクライアントのクイックスタートガイド

クライアントのセットアップ

uv init mcp_client
cd mcp_client/
uv run main.py                     # 仮想環境を作成します

uv add mcp

touch client_stdio.py              # MCPクライアントの実装ファイルを作成します

クライアントの実行

mcp_client$ uv run client_stdio.py

📦 MCPオブザーバ

前提条件

最新バージョンのNode.jsとnpmを使用してください。

インストール

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.5/install.sh | bash
nvm install --lts
npm install -g npm@latest
node -v
npm -v

オブザーバの実行

npm install -g @stellar/mcp-stardust
mcp-stardust

SSEクライアント/サーバの接続

SSEサーバに接続するには、以下のコマンドを実行します。

curl --location 'http://localhost:8090/api/v1/pops?q=*<POB>' --header 'Connection: close'

または、HTTPで接続するには、以下のコマンドを実行します。

curl --location 'http://localhost:8090/api/v1/pops' --data-raw '{"q":"*<POB>","page":1}' 

📄 既知の問題

問題が発生した場合は、Python-SDK で報告してください。