MCP Swift Example Server

🚀 MCP プロトコル Swift サンプルサーバー

このサンプルサーバーは、Model Context Protocol (MCP) Swift SDK を使用し、標準入出力（stdio）を介して通信するシンプルなサーバーの作成方法をデモンストレーションします。この設定は、Claude Desktop などのアプリケーションと互換性があります。

🚀 クイックスタート

このサンプルサーバーを使用するための基本的な手順を説明します。

エコーサーバーの実行

1. このリポジトリをクローンします。

git clone https://github.com/devyhan/mcp-swift-example-server.git
cd mcp-swift-example-server

2. サーバーをビルドします。

swift build -c release

これにより、.build/release/macros-mcp-example-server に実行可能ファイルが生成されます。この実行可能ファイルの完全なパスをメモしておいてください。

Claude Desktop の設定

このサーバーを Claude Desktop で使用するには、Claude Desktop の設定ファイル (claude_desktop_config.json) に追加する必要があります。このファイルの場所は、使用しているオペレーティングシステムによって異なります。

mcpServers オブジェクトに以下のような内容を追加し、/PATH/TO/YOUR/SERVER/ を実際のサーバーのディレクトリの絶対パスに置き換えてください。

{
    "mcpServers": {
        // ... 他のサーバー設定 ...
        "swift_echo_example": {
            "command": "/PATH/TO/YOUR/SERVER/mcp-swift-example-server/.build/release/macros-mcp-example-server"
        }
        // ... 他のサーバー設定 ...
    }
}

• swift_echo_example：Claude Desktop でサーバーを参照するときに使用する名前です（変更可能）。
• command：このフィールドは、前の手順でビルドした実行可能ファイルの実際の絶対パスである必要があります。

✨ 主な機能

このシンプルなサーバーは、以下の機能をデモンストレーションしています。

• 基本的な MCP サーバーの設定
• カスタムツール (swift_echo) の定義と登録
• ListTools および CallTool リクエストの処理
• StdioTransport を使用した通信
• 標準エラー出力への詳細なログ記録

📦 インストール

このサンプルサーバーを使用するには、以下の環境が必要です。

• macOS 13 以上
• Swift 5.9 以上

💻 使用例

クライアントの実行例

Examples ディレクトリには、MCP サーバーと通信する方法を示す簡単なクライアント実装が含まれています。

# まず、1つのターミナルでサーバーを起動します。
swift run

# 次に、別のターミナルでクライアントのサンプルを実行します。
cd Examples
swift SimpleClient.swift

📚 ドキュメント

プロジェクト構成

• main.swift：サーバーアプリケーションのエントリーポイント
• MCPServer：MCP プロトコルサーバーの実装
• EchoToolbox：基本的なエコーツールを提供するツールボックス

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。

🔗 参考資料

• MCP 仕様
• Swift MCP SDK GitHub リポジトリ