MCP Swift Example Server

🚀 MCP 协议 Swift 示例服务器

本项目是一个使用 Swift 语言开发的示例服务器，基于 Model Context Protocol (MCP) Swift SDK，通过标准输入输出（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 配置文件 (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 进行通信
• 详细的日志记录到标准错误输出

💻 使用示例

基础用法

启动服务器与客户端

# 首先在一个终端中启动服务器：
swift run

# 然后在另一个终端中运行客户端示例：
cd Examples
swift SimpleClient.swift

📚 详细文档

兼容性要求

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

项目结构

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

📄 许可证

本项目采用 MIT 许可证。

🔗 参考资料

• MCP 规范
• Swift MCP SDK GitHub 仓库