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 仓库