MCP Swift Example Server

🚀 MCP 協議 Swift 示例服務器

本項目是一個使用 Swift 語言實現的示例服務器，基於 Model Context Protocol (MCP) 協議，通過標準輸入輸出（stdio）進行通信。它能與 Claude Desktop 等應用程序兼容，為開發者展示瞭如何搭建一個簡單的 MCP 服務器。

🚀 快速開始

運行回聲服務器

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_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：該字段必須是上一步構建的可執行文件的實際絕對路徑。

客戶端示例

Examples 目錄下有一個簡單的客戶端實現，可演示如何與 MCP 服務器通信：

# 先在一個終端中啟動服務器：
swift run

# 然後在另一個終端中運行客戶端示例：
cd Examples
swift SimpleClient.swift

✨ 主要特性

• 設置基本的 MCP 服務器。
• 定義並註冊自定義工具 (swift_echo)。
• 處理 ListTools 和 CallTool 請求。
• 使用 StdioTransport 進行通信。
• 詳細的日誌記錄到標準錯誤輸出。

📚 詳細文檔

兼容性要求

• macOS 13 或更高版本。
• Swift 5.9 或更高版本。

項目結構

• main.swift：服務器應用程序的入口點。
• MCPServer：MCP 協議服務器實現。
• EchoToolbox：提供基本回顯工具的工具箱。

📄 許可證

本項目採用 MIT 許可證。

🔗 參考資料

• MCP 規範
• Swift MCP SDK GitHub 倉庫