MCP Swift 示例服务器

基本 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": {
        // ... 其他服务器（如果有）...
        "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

要求

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

项目结构

• main.swift: 服务器应用程序的入口点
• MCPServer: MCP 协议服务器实现
• EchoToolbox: 提供基本 echo 工具的工具箱

许可证

MIT

参考

• MCP 规范
• Swift MCP SDK GitHub