Swift Fast MCP

MCPAI代理

提供方 mehmetbaykar

AI代理 未标注 Token 社区 / 第三方 Claude DesktopClaude

FastMCP是一个用于快速构建MCP服务器的Swift工具,支持多种传输方式和工具集成。

一句话选型结论

按资料字段整理

Swift Fast MCP 属于AI代理类 MCP 服务器,传输方式未标注,Token,可直接接入 Claude Desktop、Claude,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式未标注 鉴权Token 部署方式未标注
GitHub 星标 8 仓库热度,无公开仓库时显示未标注
工具数 3 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量3暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

Swift本地部署Swift开发服务器构建工具集成HTTP传输MCP协议

安装与配置

未标注 Token
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 3 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 3 个工具,职责相对集中,接入后不容易误操作。
  • 已适配 Claude Desktop、Claude,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Swift Fast MCP当前 3 未标注 未标注 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方mehmetbaykar上游标注的维护方 mehmetbaykar
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

12.7 KB
来自项目仓库与上游目录的原文,未做删改

FastMCP

在Swift中构建MCP服务器的最快方法。

If you found this helpful, you can support more open source work!

__________```swift
try await FastMCP.builder()
.name("My Server")
.addTools([WeatherTool()])
.run()


通过stdio连接到工作的MCP服务器的三条线路。或者通过HTTP服务:```swift
try await FastMCP.builder()
.name("My Server")
.addTools([WeatherTool()])
.transport(.http(port: 8080))
.run()

或者从另一个Streamable HTTP MCP服务器聚合工具并公开它们
在您本地的Swift工具旁边:```swift
try await FastMCP.builder()
.name("Gateway")
.addTools([WeatherTool()])
.addUpstreamMCPServers([
.streamableHTTP(
name: "firecrawl",
endpoint: URL(string: "https://mcp.firecrawl.dev/v2/mcp")!,
headers: ["Authorization": "Bearer "]
)
])
.run()


## 安装

添加到您的 `Package.swift`:```swift
dependencies: [
.package(url: "https://github.com/mehmetbaykar/swift-fast-mcp", from: "2.7.0")
]

然后添加 "FastMCP" 作为目标的依赖:```swift
.target(
name: "MyServer",
dependencies: [
.product(name: "FastMCP", package: "swift-fast-mcp")
]
)


FastMCP会自动引入这些依赖关系:

- swift sdk --MCP Swift官方SDK
- swift人工智能中心 -- `@Tool` / `@Generable` / `@Parameter` / `@Guide` 宏和 `Tool` 协议表面
- 快速服务生命周期 --优雅的关机
- swift语法 --编译器插件 `@MCPPrompt` / `@MCPResource`
- 斯威夫特·尼奥 --HTTP传输(NIO是一个内部依赖项;不会重新导出)

`FastMCPAIBridge` 故意公开并通过以下方式再出口 `FastMCP` 为了
高级桥接测试和自定义适配器使用。大多数应用程序仍应
更喜欢构建器API。

## 快速开始

### 标准传输(默认)```swift
import FastMCP

@Tool("Get weather for a location")
struct WeatherTool {
@Parameter("City or coordinates")
var location: String = ""

func execute() async throws -> String {
"Weather in \(location): 22°C, Sunny"
}
}

@main
struct MyServer {
static func main() async throws {
try await FastMCP.builder()
.name("Weather Server")
.addTools([WeatherTool()])
.run()
}
}

通过添加将其连接到Claude Desktop claude_desktop_config.json:```json
{
"mcpServers": {
"weather": {
"command": "/path/to/my-server"
}
}
}


### HTTP传输```swift
@main
struct MyServer {
static func main() async throws {
try await FastMCP.builder()
.name("Weather Server")
.addTools([WeatherTool()])
.transport(.http(port: 8080))
.run()
// Listening on http://127.0.0.1:8080/mcp
}
}

交通方式```swift

public enum Transport: Sendable {
case stdio
case inMemory
case http(
mode: HTTPMode = .stateful,
host: String = "127.0.0.1",
port: Int = 3000,
endpoint: String = "/mcp"
)
case custom(MCP.Transport)
}


|运输|用例|
|-----------|----------|
| `.stdio` |Claude Desktop,CLI工具。违约。 |
| `.inMemory` |单元测试。 |
| `.http(...)` |远程服务器、多客户端访问、web部署。 |
| `.custom(transport)` |提供您自己的 `MCP.Transport` 实施。 |

### Http模式```swift
public enum HTTPMode: Sendable {
case stateful
case stateless
}

有状态的 (默认)--完全MCP流式HTTP。每个客户端都可以通过以下方式获得与SSE流的会话,并可恢复 Last-Event-IDGET表示服务器发起的消息,DELETE表示会话终止。

无状态 --最小HTTP。无会话,直接JSON响应,仅POST。当会话管理由外部处理或不需要时使用。```swift
// Stateful (default)
.transport(.http(port: 8080))
.transport(.http(mode: .stateful, host: "0.0.0.0", port: 3000, endpoint: "/mcp"))

// Stateless
.transport(.http(mode: .stateless, port: 8080))


## 生成器API

所有生成器方法都返回一个新的 `Builder` (值语义),并且可以被链接。

### 服务器元数据```swift
.name("My Server")               // Server name (default: process name)
.version("2.7.0")                // Server version (default: "1.0.0")
.title("My Display Name")        // Human-readable display name for UIs
.instructions("Use this server to...") // Instructions for LLM clients
.icons([...])                     // Server icons for display in UIs

能力```swift

try FastMCP.builder()
.addTools([WeatherTool(), MathTool(), StructuredSearchTool()]) // Register tool implementations
.addUpstreamMCPServers([ // Proxy Streamable HTTP upstream tools as docs_*
.streamableHTTP(name: "docs", endpoint: docsMCPURL)
])
.addResources([ConfigResource()]) // Register resource implementations
.addPrompts([GreetingPrompt()]) // Register prompt implementations
.enableCompletions() // Advertise completions capability
.enableLogging() // Advertise logging capability


重复的上游服务器名称和工具名称会提前失败。资源和提示
自动进行重复数据消除;第一次注册获胜。

延迟的SwiftAIHub工具源代码异步解析,因此 `addTools(_:)` 是
也可作为 `async throws` 建筑商电话:```swift
import FastMCP

try await FastMCP.builder()
.addTools(localOrDeferredToolSource)
.run()

使用 addUpstreamMCPServers(...) 当您希望FastMCP充当MCP网关时
用于远程MCP工具,同时保留其MCP描述符和调用结果。

交通和基础设施```swift

.transport(.stdio) // Transport selection (default: .stdio)
.logger(myLogger) // Custom swift-log Logger
.shutdownSignals([.sigterm, .sigint]) // Unix signals for graceful shutdown (default: both)


### 生命周期挂钩

在...之下 `.stdio` (默认),stdout携带JSON-RPC帧——不要使用 `print` 在钩子。通过注入的路由消息 `Logger` 相反(swift日志的默认处理程序会写入stderr)。在...之下 `.http`,任何一种方法都是安全的。```swift
.onStart { logger.info("Server started") }
.onShutdown { logger.info("Server stopped") }
.onInitialize { clientInfo, capabilities in
// Called when a client sends an initialize request.
// Receives Client.Info and Client.Capabilities.
// Useful for auth checks, logging, per-client setup.
// Especially valuable for HTTP where multiple clients connect.
logger.info("Client: \(clientInfo.name) v\(clientInfo.version)")
}

HTTP特定配置```swift

.sessionTimeout(.seconds(1800)) // Idle session timeout (default: 3600s)
// Only applies to .http with .stateful mode.

.httpValidation(
allowedOrigins: ["https://example.com"], // Allowed Origin headers (default: localhost only)
customValidators: [MyAuthValidator()] // Custom HTTPRequestValidator implementations
)


### 跑步```swift
.run()  // Starts the server and blocks until shutdown

HTTP传输

多会话模型

在有状态HTTP模式下,每个连接的客户端都有自己独立的 Server + Transport 一对。服务器自动管理会话生命周期。

会话生命周期(有状态模式)

  1. 客户端向发送POST /mcp 带着一个 initialize JSON-RPC请求(无会话头)。
  2. 服务器创建新 StatefulHTTPServerTransport + Server 配对,注册所有工具/资源/提示。
  3. 传输生成会话ID,并在 Mcp-Session-Id 响应标头。
  4. 后续请求包含此标头,并被路由到匹配的会话。
  5. 客户端发送DELETE以终止会话。
  6. 清理循环每60秒运行一次,删除空闲时间超过 sessionTimeout.

无状态模式

  1. 客户端向发送POST /mcp 通过JSON-RPC请求。
  2. 服务器直接使用JSON进行响应。没有SSE,没有会话头,没有会话跟踪。

验证流程

HTTP服务器在处理之前验证传入的请求。默认情况下,只允许使用localhost源。

要允许远程来源或添加自定义验证(例如,承载令牌身份验证),请使用 .httpValidation():```swift
.httpValidation(
allowedOrigins: ["https://myapp.com", "https://staging.myapp.com"],
customValidators: [BearerTokenValidator(expectedToken: "...")]
)


自定义验证器符合 `HTTPRequestValidator` 来自MCP SDK。

### 传输层安全

FastMCP不处理TLS。部署在HTTPS的反向代理(nginx、Caddy)后面。

## 工具

AI可调用函数,具有从任一平面生成的JSON模式 `@Parameter`
存储属性+ `execute()`,或嵌套 `@Generable` `Arguments` 结构
加 `execute(_:)`该工具的名称来源于结构体名称
(`MathTool` → `math`)以及它从body返回的类型 `execute`:```swift
@Generable
enum Operation: String, CaseIterable {
case add, subtract, multiply, divide
}

@Tool("Perform math operations")
struct MathTool {
@Generable
struct Arguments {
@Parameter("Operation") var operation: Operation
@Parameter("First operand") var a: Double
@Parameter("Second operand") var b: Double
}

func execute(_ arguments: Arguments) async throws -> String {
let result = switch arguments.operation {
case .add: arguments.a + arguments.b
case .subtract: arguments.a - arguments.b
case .multiply: arguments.a * arguments.b
case .divide: arguments.a / arguments.b
}
return "Result: \(result)"
}
}

资源

将数据暴露给AI模型:```swift
@MCPResource(
"config://app/settings",
name: "App Settings",
description: "Application configuration",
mimeType: .applicationJSON
)
struct ConfigResource {
@ResourceContentBuilder
var content: Content {
"""
{"theme": "dark", "version": "1.0.0"}
"""
}
}


## 提示

带有键入参数的可重用对话模板 `@PromptArgument`:```swift
@MCPPrompt("A greeting template")
struct GreetingPrompt {
@PromptArgument("Who to greet")
var name: String

@PromptArgument("Use formal tone")
var formal: Bool = false

func getMessages() async throws -> Messages {
if formal {
return [
.user("You are a formal assistant helping \(name)."),
.assistant("Good day, \(name). How may I assist you?"),
]
} else {
return [
.user("You are a friendly assistant helping \(name)."),
.assistant("Hey \(name)! What can I help you with?"),
]
}
}
}

完整示例

一个完整的stdio服务器,包括工具、资源、提示和生命周期挂钩——Claude Desktop和CLI客户端的规范MCP设置,将服务器作为子进程生成。这与发货中使用的stdio传输/生命周期模式相匹配 Sources/Example/ExampleServer.swift (它连接了自己的工具和元数据)。对于HTTP特定的变体( .httpValidation, .sessionTimeout等),请参阅 HTTP传输 上面的部分。```swift
import FastMCP
import Logging

@main
struct ExampleServer {
static func main() async throws {
let logger: Logger = {
var log = Logger(label: "my-server")
log.logLevel = .info
return log
}()

try await FastMCP.builder()
.name("Example Server")
.title("Example MCP Server")
.version("2.7.0")
.instructions("This server provides weather, math, and structured search tools.")

.addTools([WeatherTool(), MathTool(), StructuredSearchTool()])
.addResources([ConfigResource()])
.addPrompts([GreetingPrompt()])

.enableCompletions()
.enableLogging()

.transport(.stdio)

.logger(logger)
.shutdownSignals([.sigterm, .sigint])

// Stdio owns stdout for JSON-RPC framing — route lifecycle messages
// through logger (stderr) so print never corrupts the wire.
.onInitialize { clientInfo, _ in
logger.info("Client connected: (clientInfo.name) v(clientInfo.version)")
}
.onStart {
logger.info("Server started on stdio")
}
.onShutdown {
logger.info("Server shutting down")
}

.run()
}
}


## 平台支持

- macOS 14+
- Linux(通过 `#if canImport(FoundationNetworking)` 警卫)
- Swift 6.2+

## Claude代码集成

FastMCP配备 Claude代码技能 和一个 子代理 让Claude Code为您搭建和构建MCP服务器项目。

### 设置

复制 `skills/` 和 `.claude/` 项目中的目录:```bash
# Copy the skill (project scaffolding)
cp -r skills/ .claude/skills/

# Copy the agent (expert assistance)
cp -r .claude/agents/ .claude/agents/

用法

搭建一个新项目 凭借技能:```
/swift-fast-mcp MyServer tools,resources,prompts


Claude使用Package.swift、键入的工具/资源/提示、测试和Claude Desktop配置生成一个完整的项目。

**获得专家帮助** 与子代理:

克劳德自动委托给 `swift-mcp-expert` 当你问起 `@Tool`, `@MCPResource`, `@MCPPrompt` 实现、构建器API, `@Generable` 例如类型或测试模式。您还可以显式调用它:```
Use the swift-mcp-expert to help me build a weather tool

文档

  • docs/Tools.md --暴露 @Tool 通过MCP服务器从swift ai hub传输结构
  • docs/PromptsResources.md — @MCPPrompt, @MCPResource, @PromptArgument, MCPResourceMimeType
  • docs/Transports.md --stdio、HTTP(有状态/无状态)、内存中、自定义; httpValidation;服务组生命周期
  • docs/DynamicServers.md — FastMCPServerHandle 用于在以下操作后添加/删除工具、资源和提示 run() 开始

这 @Tool, @Generable, @Parameter,以及 @Guide 宏来自
swift人工智能中心 --看看它
docs/Macros.md
供宏观参考。

许可证

麻省理工学院

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
Swift Fast MCP 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Swift Fast MCP 怎么在 Claude Desktop、Claude 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Swift Fast MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Swift Fast MCP 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

Swift Fast MCP 支持哪些客户端?

资料标注支持 Claude Desktop、Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Swift Fast MCP 能提供哪些能力?

资料显示约 3 个工具;能力标签包括 Swift、服务器构建、HTTP传输、Claude。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。