$npx -y skills add github/awesome-copilot --skill swift-mcp-server-generatorGenerate a complete Model Context Protocol server project in Swift using the official MCP Swift SDK package.
| 1 | # Swift MCP Server Generator |
| 2 | |
| 3 | Generate a complete, production-ready MCP server in Swift using the official Swift SDK package. |
| 4 | |
| 5 | ## Project Generation |
| 6 | |
| 7 | When asked to create a Swift MCP server, generate a complete project with this structure: |
| 8 | |
| 9 | ``` |
| 10 | my-mcp-server/ |
| 11 | ├── Package.swift |
| 12 | ├── Sources/ |
| 13 | │ └── MyMCPServer/ |
| 14 | │ ├── main.swift |
| 15 | │ ├── Server.swift |
| 16 | │ ├── Tools/ |
| 17 | │ │ ├── ToolDefinitions.swift |
| 18 | │ │ └── ToolHandlers.swift |
| 19 | │ ├── Resources/ |
| 20 | │ │ ├── ResourceDefinitions.swift |
| 21 | │ │ └── ResourceHandlers.swift |
| 22 | │ └── Prompts/ |
| 23 | │ ├── PromptDefinitions.swift |
| 24 | │ └── PromptHandlers.swift |
| 25 | ├── Tests/ |
| 26 | │ └── MyMCPServerTests/ |
| 27 | │ └── ServerTests.swift |
| 28 | └── README.md |
| 29 | ``` |
| 30 | |
| 31 | ## Package.swift Template |
| 32 | |
| 33 | ```swift |
| 34 | // swift-tools-version: 6.0 |
| 35 | import PackageDescription |
| 36 | |
| 37 | let package = Package( |
| 38 | name: "MyMCPServer", |
| 39 | platforms: [ |
| 40 | .macOS(.v13), |
| 41 | .iOS(.v16), |
| 42 | .watchOS(.v9), |
| 43 | .tvOS(.v16), |
| 44 | .visionOS(.v1) |
| 45 | ], |
| 46 | dependencies: [ |
| 47 | .package( |
| 48 | url: "https://github.com/modelcontextprotocol/swift-sdk.git", |
| 49 | from: "0.10.0" |
| 50 | ), |
| 51 | .package( |
| 52 | url: "https://github.com/apple/swift-log.git", |
| 53 | from: "1.5.0" |
| 54 | ), |
| 55 | .package( |
| 56 | url: "https://github.com/swift-server/swift-service-lifecycle.git", |
| 57 | from: "2.0.0" |
| 58 | ) |
| 59 | ], |
| 60 | targets: [ |
| 61 | .executableTarget( |
| 62 | name: "MyMCPServer", |
| 63 | dependencies: [ |
| 64 | .product(name: "MCP", package: "swift-sdk"), |
| 65 | .product(name: "Logging", package: "swift-log"), |
| 66 | .product(name: "ServiceLifecycle", package: "swift-service-lifecycle") |
| 67 | ] |
| 68 | ), |
| 69 | .testTarget( |
| 70 | name: "MyMCPServerTests", |
| 71 | dependencies: ["MyMCPServer"] |
| 72 | ) |
| 73 | ] |
| 74 | ) |
| 75 | ``` |
| 76 | |
| 77 | ## main.swift Template |
| 78 | |
| 79 | ```swift |
| 80 | import MCP |
| 81 | import Logging |
| 82 | import ServiceLifecycle |
| 83 | |
| 84 | struct MCPService: Service { |
| 85 | let server: Server |
| 86 | let transport: Transport |
| 87 | |
| 88 | func run() async throws { |
| 89 | try await server.start(transport: transport) { clientInfo, capabilities in |
| 90 | logger.info("Client connected", metadata: [ |
| 91 | "name": .string(clientInfo.name), |
| 92 | "version": .string(clientInfo.version) |
| 93 | ]) |
| 94 | } |
| 95 | |
| 96 | // Keep service running |
| 97 | try await Task.sleep(for: .days(365 * 100)) |
| 98 | } |
| 99 | |
| 100 | func shutdown() async throws { |
| 101 | logger.info("Shutting down MCP server") |
| 102 | await server.stop() |
| 103 | } |
| 104 | } |
| 105 | |
| 106 | var logger = Logger(label: "com.example.mcp-server") |
| 107 | logger.logLevel = .info |
| 108 | |
| 109 | do { |
| 110 | let server = await createServer() |
| 111 | let transport = StdioTransport(logger: logger) |
| 112 | let service = MCPService(server: server, transport: transport) |
| 113 | |
| 114 | let serviceGroup = ServiceGroup( |
| 115 | services: [service], |
| 116 | configuration: .init( |
| 117 | gracefulShutdownSignals: [.sigterm, .sigint] |
| 118 | ), |
| 119 | logger: logger |
| 120 | ) |
| 121 | |
| 122 | try await serviceGroup.run() |
| 123 | } catch { |
| 124 | logger.error("Fatal error", metadata: ["error": .string("\(error)")]) |
| 125 | throw error |
| 126 | } |
| 127 | ``` |
| 128 | |
| 129 | ## Server.swift Template |
| 130 | |
| 131 | ```swift |
| 132 | import MCP |
| 133 | import Logging |
| 134 | |
| 135 | func createServer() async -> Server { |
| 136 | let server = Server( |
| 137 | name: "MyMCPServer", |
| 138 | version: "1.0.0", |
| 139 | capabilities: .init( |
| 140 | prompts: .init(listChanged: true), |
| 141 | resources: .init(subscribe: true, listChanged: true), |
| 142 | tools: .init(listChanged: true) |
| 143 | ) |
| 144 | ) |
| 145 | |
| 146 | // Register tool handlers |
| 147 | await registerToolHandlers(server: server) |
| 148 | |
| 149 | // Register resource handlers |
| 150 | await registerResourceHandlers(server: server) |
| 151 | |
| 152 | // Register prompt handlers |
| 153 | await registerPromptHandlers(server: server) |
| 154 | |
| 155 | return server |
| 156 | } |
| 157 | ``` |
| 158 | |
| 159 | ## ToolDefinitions.swift Template |
| 160 | |
| 161 | ```swift |
| 162 | import MCP |
| 163 | |
| 164 | func getToolDefinitions() -> [Tool] { |
| 165 | [ |
| 166 | Tool( |
| 167 | name: "greet", |
| 168 | description: "Generate a greeting message", |
| 169 | inputSchema: .object([ |
| 170 | "type": .string("object"), |
| 171 | "properties": .object([ |
| 172 | "name": .object([ |
| 173 | "type": .string("string"), |
| 174 | "description": .string("Name to greet") |
| 175 | ]) |
| 176 | ]), |
| 177 | "required": .array([.string("name")]) |
| 178 | ]) |
| 179 | ), |
| 180 | Tool( |
| 181 | name: "calculate", |
| 182 | description: "Perform mathematical calculations", |
| 183 | inputSchema: .object([ |
| 184 | "type": .string("object"), |
| 185 | "properties": .object([ |
| 186 | "operation": .object([ |
| 187 | "type": .string("string"), |
| 188 | "enum": .array([ |
| 189 | .string("add"), |