基本能力
产品定位
MCP Template 是一个用于构建 MCP 服务器的模板项目，适用于 macOS 应用程序和命令行工具的开发。
核心功能
- 提供基本的 Swift 包结构
- 包含命令行 "hello world" 示例工具
- 支持通过
run命令直接进行 MCP 交互的命令行 stdio - 计划支持 App Store 安全的命令行 stdio 到独立 Mac 应用的通信
- 计划支持基于 SSE 的 MCP 服务器示例
适用场景
- 开发者需要快速构建 MCP 服务器的场景
- 需要参考 MCP 集成实现的开发项目
- 需要基础 MCP 概念演示的教育或学习场景
工具列表
- EasyMCP (Library)
- 最小化的 MCP 服务器模板实现
- 展示与 MCP 协议的基本集成
- 演示如何利用官方的
mcp-swift-sdk -
包含一个简单的工具示例（helloworld）
-
mcpexample (Executable)
- 使用 EasyMCP 库的简单命令行示例
- 包含 hello 命令和 run 命令
- run 命令使用 stdio 传输启动完整的 MCP 服务器
-
使用
ArgumentParser处理 CLI 参数 -
EasyMCPTests (Test Target)
- 对 EasyMCP 库功能进行模板测试
- 包含对 hello 函数的基本测试
常见问题解答
- 使用 MCP Inspector 可以诊断和调试自定义 MCP 服务器
- 调试时可以通过 Xcode 附加到进程进行实时调试
- 日志文件位于
~/Library/Logs/Claude/mcp*.log
使用教程
使用依赖
- swift-argument-parser (1.3.0+) - 用于 CLI 参数处理
- mcp-swift-sdk (branch: "feature/wait-for-complete") - 自定义的 MCP 实现分支
安装教程
Swift Package Manager
添加以下内容到你的 Package.swift 文件:
swift
dependencies: [
.package(url: "https://github.com/your-username/mcp-template.git", branch: "main"),
]
然后添加依赖到你的目标:
swift
.target(
name: "YourTarget",
dependencies: [
.product(name: "EasyMCP", package: "mcp-template")
]
),
调试方式
- 在 Xcode 中构建你的命令行可执行文件
- 通过 Xcode → Product → Show Build Folder in Finder 定位可执行文件
- 复制该目录中可执行文件的绝对路径
- 使用 MCP Inspector 测试你的服务器
- 在终端运行:
bash
npx @modelcontextprotocol/inspector <absolute_path_to_your_executable> run - 在浏览器中打开输出显示的端口
- 在 MCP Inspector 界面点击 Connect 按钮
- 在 Activity Monitor 中搜索你的可执行文件名
- 验证只有 inspector 和你的工具的一个实例在运行
- 在 Xcode → Debug → Attach to Process → 找到你的可执行文件名并附加
- 在终端运行
tail -n 20 -f ~/Library/Logs/Claude/mcp*.log - 现在你可以通过 inspector 与服务器交互，同时在 Xcode 中命中断点
