MCP Template

基本能力

产品定位

MCP Template 是一个用于构建 MCP 服务器的模板项目，适用于 macOS 应用程序和命令行工具的开发。

核心功能

• 提供基本的 Swift 包结构
• 包含命令行 "hello world" 示例工具
• 支持通过 run 命令直接进行 MCP 交互的命令行 stdio
• 计划支持 App Store 安全的命令行 stdio 到独立 Mac 应用的通信
• 计划支持基于 SSE 的 MCP 服务器示例

适用场景

• 开发者需要快速构建 MCP 服务器的场景
• 需要参考 MCP 集成实现的开发项目
• 需要基础 MCP 概念演示的教育或学习场景

工具列表

1. EasyMCP (Library)
2. 最小化的 MCP 服务器模板实现
3. 展示与 MCP 协议的基本集成
4. 演示如何利用官方的 mcp-swift-sdk

5. 包含一个简单的工具示例（helloworld）

6. mcpexample (Executable)

7. 使用 EasyMCP 库的简单命令行示例
8. 包含 hello 命令和 run 命令
9. run 命令使用 stdio 传输启动完整的 MCP 服务器

10. 使用 ArgumentParser 处理 CLI 参数

11. EasyMCPTests (Test Target)

12. 对 EasyMCP 库功能进行模板测试
13. 包含对 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 文件:

dependencies: [
    .package(url: "https://github.com/your-username/mcp-template.git", branch: "main"),
]

然后添加依赖到你的目标:

.target(
    name: "YourTarget",
    dependencies: [
        .product(name: "EasyMCP", package: "mcp-template")
    ]
),

调试方式

1. 在 Xcode 中构建你的命令行可执行文件
2. 通过 Xcode → Product → Show Build Folder in Finder 定位可执行文件
3. 复制该目录中可执行文件的绝对路径
4. 使用 MCP Inspector 测试你的服务器
5. 在终端运行: bash npx @modelcontextprotocol/inspector <absolute_path_to_your_executable> run
6. 在浏览器中打开输出显示的端口
7. 在 MCP Inspector 界面点击 Connect 按钮
8. 在 Activity Monitor 中搜索你的可执行文件名
9. 验证只有 inspector 和你的工具的一个实例在运行
10. 在 Xcode → Debug → Attach to Process → 找到你的可执行文件名并附加
11. 在终端运行 tail -n 20 -f ~/Library/Logs/Claude/mcp*.log
12. 现在你可以通过 inspector 与服务器交互，同时在 Xcode 中命中断点

许可证

该项目遵循 MIT 开源许可条款。