MCP Swift Example Server

MCP Swift Example Server

基本的な Stdio の例

この基本的な例では、Model Context Protocol Swift SDK を使用して、標準入出力（stdio）で通信するシンプルなサーバーの作成方法を紹介します。この構成は、Claude Desktop などのアプリケーションと互換性があります。

機能

このシンプルなサーバーでは、以下の方法を紹介します。

• 基本的な MCP サーバーのセットアップ
• カスタムツール（swift_echo）の定義と登録
• ListTools および CallTool リクエストの処理
• 通信に StdioTransport を使用
• stderr への詳細なログ記録

はじめに

Echo サーバーの実行

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）に追加する必要があります。このファイルの場所は、オペレーティングシステムによって異なります。

claude_desktop_config.json の mcpServers オブジェクトに、次のようなエントリを追加します。/PATH/TO/YOUR/SERVER/ は、お使いのシステム上のリポジトリディレクトリの実際の絶対パスに置き換えてください。

{
    "mcpServers": {
        // ... other servers maybe ...
        "swift_echo_example": {
            "command": "/PATH/TO/YOUR/SERVER/mcp-swift-example-server/.build/release/macros-mcp-example-server"
        }
        // ... other servers maybe ...
    }
}

• swift_echo_example：Claude Desktop 内でサーバーを参照する際の名前です（変更できます）。
• command：前の手順でビルドした実行ファイルの絶対パスを必ず指定してください。

クライアントの例

Examples ディレクトリには、MCP サーバーとの通信方法を紹介するシンプルなクライアントの実装があります。

# First start the server in one terminal:
swift run

# Then in another terminal, run the client example:
cd Examples
swift SimpleClient.swift

要件

• macOS 13 以降
• Swift 5.9 以降

プロジェクト構成

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

ライセンス

MIT

参考資料

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