Initial commit

Author: mattt

.gitignore

@@ -0,0 +1,8 @@
+.DS_Store
+/.build
+/Packages
+xcuserdata/
+DerivedData/
+.swiftpm/configuration/registries.json
+.swiftpm/xcode/package.xcworkspace/contents.xcworkspacedata
+.netrc

Package.swift

@@ -0,0 +1,31 @@
+// swift-tools-version:5.7
+// The swift-tools-version declares the minimum version of Swift required to build this package.
+
+import PackageDescription
+
+let package = Package(
+    name: "mcp-swift-sdk",
+    platforms: [
+        .macOS(.v12),
+        .iOS(.v15),
+        .tvOS(.v15),
+        .watchOS(.v8)
+    ],
+    products: [
+        // Products define the executables and libraries a package produces, making them visible to other packages.
+        .library(
+            name: "MCP",
+            targets: ["MCP"]),
+    ],
+    dependencies: [],
+    targets: [
+        // Targets are the basic building blocks of a package, defining a module or a test suite.
+        // Targets can depend on other targets in this package and products from dependencies.
+        .target(
+            name: "MCP",
+            dependencies: []),
+        .testTarget(
+            name: "MCPTests",
+            dependencies: ["MCP"]),
+    ]
+)

README.md

@@ -0,0 +1,115 @@
+# MCP Swift SDK
+
+A Swift implementation of the Model Context Protocol (MCP) client. This SDK provides a modern, Swift-native way to interact with MCP servers.
+
+## Features
+
+- Full async/await support
+- Type-safe API
+- Resource management
+- Tool integration
+- Configurable transport layer
+- Swift concurrency with actor-based design
+
+## Requirements
+
+- Swift 5.7+
+- macOS 12.0+
+- iOS 15.0+
+- tvOS 15.0+
+- watchOS 8.0+
+
+## Installation
+
+### Swift Package Manager
+
+Add the following to your `Package.swift` file:
+
+```swift
+dependencies: [
+    .package(url: "https://github.com/yourusername/mcp-swift-sdk.git", from: "1.0.0")
+]
+```
+
+## Usage
+
+### Basic Setup
+
+```swift
+import MCP
+
+// Create a transport (e.g., StdioTransport)
+let transport = StdioTransport(command: "/path/to/server")
+
+// Create client info
+let clientInfo = Implementation(name: "MyApp", version: "1.0.0")
+
+// Initialize the client
+let client = MCPClient(transport: transport, clientInfo: clientInfo)
+
+// Connect and initialize
+try await client.connect()
+let result = try await client.initialize()
+```
+
+### Working with Resources
+
+```swift
+// List available resources
+let resources = try await client.listResources()
+
+// Read a resource
+let resource = try await client.readResource("resource://example")
+
+// Subscribe to resource updates
+try await client.subscribeResource("resource://example")
+
+// Unsubscribe from resource updates
+try await client.unsubscribeResource("resource://example")
+```
+
+### Working with Tools
+
+```swift
+// List available tools
+let tools = try await client.listTools()
+
+// Call a tool
+let result = try await client.callTool(name: "example-tool", arguments: ["key": "value"])
+```
+
+### Custom Transport
+
+You can create your own transport by implementing the `MCPTransport` protocol:
+
+```swift
+public protocol MCPTransport {
+    func connect() async throws
+    func disconnect() async
+    func sendRequest(_ data: Data) async throws -> Data
+    func sendNotification(_ data: Data) async throws
+}
+```
+
+## Error Handling
+
+The SDK uses the `MCPError` type for error handling:
+
+```swift
+public enum MCPError: LocalizedError {
+    case connectionClosed
+    case invalidResponse
+    case invalidParams(String)
+    case serverError(String)
+    case protocolError(String)
+    case transportError(Error)
+}
+```
+
+## Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## License
+
+This project is licensed under the MIT License - see the LICENSE file for details.