V0.11.x (#199)
* Support 2025-06-18 Spec (#167) * Support OpenAI _meta for Tool * Update init * Add title and outputSchema * Concurreny issue * General fields * Add Generate Fields to Server elements * 4 tab spacing * Update Version * Elicitation * Format * More tests and inits * Elicitation in README * Fix orphaned test * Add title to more structs * Public init * Fix meta validation and make tests more generic * Format and make Result properties public again * Revert more visibility changes * feat: 2025-11-25 phase 1, includes Version, Icon, Progress (#181) * chore: fixed unit tests * feat: added icon and progess base structs * feat: added progress notification and meta to callTool * feat: added tests * feat: simplified RequestMeta encoding/decoding * tests: added unit test to track progress * chore: rebased v0.11.x * feat: implemented cancellation * feat: added overloaded callTool method * fix: encoding Response _meta fix * chore: added old version to the versions list * feat: 2025-11-25 phase 2; added Logging and Completions (#196) * feat: added Logging and Completions * feat: updated EmbeddedResource for the latest spec * chore: changed encoding of meta in Prompts to encodeIfPresent * feat: compliance tests + http server transport (#197) * feat: http server transport * feat: added http server transport * feat: removed unused files * feat: added conformance tests * feat: improved conformace testing * chore: removed redundant files * feat/2025-11-25: sampling, elicitation, roots (#198) * feat: Roots implementation * feat: added unit testing * feat: improved unit tests and fixed NetworkTransport crash * feat: implemented sampling and elicitation * feat: improved sampling tests * feat: improved elicitation tests * feat: improved confirmance tests * feat: improved Prompts unit tests * feat: removed test code * feat: updated conformance tests * chore: removed redundant commas * chore: removed 6.0.3 swift version from ci * chore: improved unit tests a little bit * chore: update README.md * chore: add server progress tracking example to README.md * chore: updated README.md * chore: updated transports table formatting * chore: updated MockNetworkConnection --------- Co-authored-by: Austin Evans <austinjevans@me.com> Co-authored-by: yehorsobko <yehorsobko@macpaw.com>
This commit is contained in:
parent
6fa1a97b41
commit
6112a3995a
1 changed files with 11854 additions and 828 deletions
899
Tests/MCPTests/HTTPServerTransportTests.swift
Normal file
899
Tests/MCPTests/HTTPServerTransportTests.swift
Normal file
|
|
@ -0,0 +1,899 @@
|
|||
import Foundation
|
||||
import Testing
|
||||
|
||||
@testable import MCP
|
||||
|
||||
// MARK: - Test Helpers
|
||||
|
||||
private struct FixedSessionIDGenerator: SessionIDGenerator {
|
||||
let sessionID: String
|
||||
func generateSessionID() -> String { sessionID }
|
||||
}
|
||||
|
||||
private func makeInitializeBody(id: String = "1") -> Data {
|
||||
let json: [String: Any] = [
|
||||
"jsonrpc": "2.0",
|
||||
"id": id,
|
||||
"method": "initialize",
|
||||
"params": [
|
||||
"protocolVersion": "2025-11-25",
|
||||
"capabilities": [:] as [String: Any],
|
||||
"clientInfo": ["name": "test", "version": "1.0"],
|
||||
] as [String: Any],
|
||||
]
|
||||
return try! JSONSerialization.data(withJSONObject: json)
|
||||
}
|
||||
|
||||
private func makeNotificationBody(method: String = "notifications/initialized") -> Data {
|
||||
let json: [String: Any] = ["jsonrpc": "2.0", "method": method]
|
||||
return try! JSONSerialization.data(withJSONObject: json)
|
||||
}
|
||||
|
||||
private func makeRequestBody(id: String = "2", method: String = "tools/list") -> Data {
|
||||
let json: [String: Any] = [
|
||||
"jsonrpc": "2.0",
|
||||
"id": id,
|
||||
"method": method,
|
||||
"params": [:] as [String: Any],
|
||||
]
|
||||
return try! JSONSerialization.data(withJSONObject: json)
|
||||
}
|
||||
|
||||
private func makeResponseBody(id: String = "2") -> Data {
|
||||
let json: [String: Any] = [
|
||||
"jsonrpc": "2.0",
|
||||
"id": id,
|
||||
"result": ["tools": []] as [String: Any],
|
||||
]
|
||||
return try! JSONSerialization.data(withJSONObject: json)
|
||||
}
|
||||
|
||||
private func makeStatefulPOSTRequest(body: Data, sessionID: String? = nil) -> HTTPRequest {
|
||||
var headers: [String: String] = [
|
||||
"Content-Type": "application/json",
|
||||
"Accept": "application/json, text/event-stream",
|
||||
]
|
||||
if let sessionID {
|
||||
headers["Mcp-Session-Id"] = sessionID
|
||||
}
|
||||
return HTTPRequest(method: "POST", headers: headers, body: body)
|
||||
}
|
||||
|
||||
private func makeGETRequest(sessionID: String, lastEventID: String? = nil) -> HTTPRequest {
|
||||
var headers: [String: String] = [
|
||||
"Accept": "text/event-stream",
|
||||
"Mcp-Session-Id": sessionID,
|
||||
]
|
||||
if let lastEventID {
|
||||
headers["Last-Event-Id"] = lastEventID
|
||||
}
|
||||
return HTTPRequest(method: "GET", headers: headers)
|
||||
}
|
||||
|
||||
private func makeDELETERequest(sessionID: String) -> HTTPRequest {
|
||||
HTTPRequest(
|
||||
method: "DELETE",
|
||||
headers: ["Mcp-Session-Id": sessionID]
|
||||
)
|
||||
}
|
||||
|
||||
private func makeStatelessPOSTRequest(body: Data) -> HTTPRequest {
|
||||
HTTPRequest(
|
||||
method: "POST",
|
||||
headers: [
|
||||
"Content-Type": "application/json",
|
||||
"Accept": "application/json",
|
||||
],
|
||||
body: body
|
||||
)
|
||||
}
|
||||
|
||||
private func makeStatefulTransport(
|
||||
sessionIDGenerator: any SessionIDGenerator = UUIDSessionIDGenerator()
|
||||
) -> StatefulHTTPServerTransport {
|
||||
StatefulHTTPServerTransport(
|
||||
sessionIDGenerator: sessionIDGenerator,
|
||||
validationPipeline: StandardValidationPipeline(validators: [])
|
||||
)
|
||||
}
|
||||
|
||||
private func makeStatelessTransport() -> StatelessHTTPServerTransport {
|
||||
StatelessHTTPServerTransport(
|
||||
validationPipeline: StandardValidationPipeline(validators: [])
|
||||
)
|
||||
}
|
||||
|
||||
/// Drains an SSE stream, collecting raw SSE chunks.
|
||||
private actor ChunkCollector {
|
||||
var chunks: [Data] = []
|
||||
func append(_ data: Data) { chunks.append(data) }
|
||||
func getChunks() -> [Data] { chunks }
|
||||
}
|
||||
|
||||
private func drainSSEStream(
|
||||
_ response: HTTPResponse,
|
||||
maxChunks: Int = 10,
|
||||
timeout: Duration = .seconds(2)
|
||||
) async -> [Data] {
|
||||
guard case .stream(let stream, _) = response else { return [] }
|
||||
let collector = ChunkCollector()
|
||||
let task = Task {
|
||||
for try await chunk in stream {
|
||||
await collector.append(chunk)
|
||||
if await collector.getChunks().count >= maxChunks { break }
|
||||
}
|
||||
}
|
||||
// Wait for stream to finish or timeout
|
||||
try? await Task.sleep(for: timeout)
|
||||
task.cancel()
|
||||
return await collector.getChunks()
|
||||
}
|
||||
|
||||
/// Initializes a stateful transport session and returns the session ID.
|
||||
/// Spawns a background task to consume the receive stream and send the init response.
|
||||
private func initializeSession(
|
||||
transport: StatefulHTTPServerTransport,
|
||||
sessionID: String? = nil
|
||||
) async throws -> String {
|
||||
try await transport.connect()
|
||||
|
||||
let initBody = makeInitializeBody()
|
||||
|
||||
// Background task: read the init request from receive() and send back a response
|
||||
let respondTask = Task {
|
||||
let stream = await transport.receive()
|
||||
for try await data in stream {
|
||||
// Check if this is the initialize request
|
||||
if let json = try? JSONSerialization.jsonObject(with: data) as? [String: Any],
|
||||
let method = json["method"] as? String, method == "initialize",
|
||||
let id = json["id"]
|
||||
{
|
||||
let idString: String
|
||||
if let s = id as? String { idString = s }
|
||||
else if let n = id as? Int { idString = String(n) }
|
||||
else { continue }
|
||||
|
||||
let responseJSON: [String: Any] = [
|
||||
"jsonrpc": "2.0",
|
||||
"id": idString,
|
||||
"result": [
|
||||
"protocolVersion": "2025-11-25",
|
||||
"serverInfo": ["name": "test", "version": "1.0"],
|
||||
"capabilities": [:] as [String: Any],
|
||||
] as [String: Any],
|
||||
]
|
||||
let responseData = try JSONSerialization.data(withJSONObject: responseJSON)
|
||||
try await transport.send(responseData)
|
||||
return
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
let response = await transport.handleRequest(
|
||||
makeStatefulPOSTRequest(body: initBody)
|
||||
)
|
||||
|
||||
// Extract session ID
|
||||
guard let sid = response.headers[HTTPHeaderName.sessionID] else {
|
||||
throw MCPError.internalError("No session ID in init response")
|
||||
}
|
||||
|
||||
// Drain the SSE stream so the response task can complete
|
||||
if case .stream(let stream, _) = response {
|
||||
Task { for try await _ in stream {} }
|
||||
}
|
||||
|
||||
// Wait for the respond task
|
||||
try? await respondTask.value
|
||||
|
||||
return sid
|
||||
}
|
||||
|
||||
// MARK: - StatefulHTTPServerTransport Tests
|
||||
|
||||
@Suite("StatefulHTTPServerTransport Tests")
|
||||
struct StatefulHTTPServerTransportTests {
|
||||
|
||||
// MARK: - Lifecycle
|
||||
|
||||
@Test("Connect succeeds")
|
||||
func testConnectSucceeds() async throws {
|
||||
let transport = makeStatefulTransport()
|
||||
try await transport.connect()
|
||||
await transport.disconnect()
|
||||
}
|
||||
|
||||
@Test("Double connect throws")
|
||||
func testDoubleConnectThrows() async throws {
|
||||
let transport = makeStatefulTransport()
|
||||
try await transport.connect()
|
||||
do {
|
||||
try await transport.connect()
|
||||
Issue.record("Expected error on double connect")
|
||||
} catch {
|
||||
// Expected
|
||||
}
|
||||
await transport.disconnect()
|
||||
}
|
||||
|
||||
@Test("Send after disconnect throws connectionClosed")
|
||||
func testSendAfterDisconnectThrows() async throws {
|
||||
let transport = makeStatefulTransport()
|
||||
try await transport.connect()
|
||||
await transport.disconnect()
|
||||
do {
|
||||
try await transport.send(Data("test".utf8))
|
||||
Issue.record("Expected connectionClosed error")
|
||||
} catch let error as MCPError {
|
||||
#expect(error == .connectionClosed)
|
||||
}
|
||||
}
|
||||
|
||||
// MARK: - POST Initialize
|
||||
|
||||
@Test("Initialize creates session and returns SSE stream")
|
||||
func testInitializeCreatesSession() async throws {
|
||||
let transport = makeStatefulTransport(
|
||||
sessionIDGenerator: FixedSessionIDGenerator(sessionID: "test-session-42")
|
||||
)
|
||||
try await transport.connect()
|
||||
|
||||
let response = await transport.handleRequest(
|
||||
makeStatefulPOSTRequest(body: makeInitializeBody())
|
||||
)
|
||||
|
||||
#expect(response.statusCode == 200)
|
||||
#expect(response.headers[HTTPHeaderName.sessionID] == "test-session-42")
|
||||
|
||||
if case .stream = response {
|
||||
// Expected
|
||||
} else {
|
||||
Issue.record("Expected .stream response, got \(response)")
|
||||
}
|
||||
|
||||
// Drain stream
|
||||
if case .stream(let stream, _) = response {
|
||||
Task { for try await _ in stream {} }
|
||||
}
|
||||
await transport.disconnect()
|
||||
}
|
||||
|
||||
@Test("Initialize with invalid session ID returns 500")
|
||||
func testInitializeWithInvalidSessionIDReturns500() async throws {
|
||||
// Control character \t is 0x09, outside valid range 0x21-0x7E
|
||||
let transport = makeStatefulTransport(
|
||||
sessionIDGenerator: FixedSessionIDGenerator(sessionID: "bad\tsession")
|
||||
)
|
||||
try await transport.connect()
|
||||
|
||||
let response = await transport.handleRequest(
|
||||
makeStatefulPOSTRequest(body: makeInitializeBody())
|
||||
)
|
||||
|
||||
#expect(response.statusCode == 500)
|
||||
}
|
||||
|
||||
@Test("Custom SessionIDGenerator is used")
|
||||
func testCustomSessionIDGenerator() async throws {
|
||||
let transport = makeStatefulTransport(
|
||||
sessionIDGenerator: FixedSessionIDGenerator(sessionID: "custom-id-abc")
|
||||
)
|
||||
try await transport.connect()
|
||||
|
||||
let response = await transport.handleRequest(
|
||||
makeStatefulPOSTRequest(body: makeInitializeBody())
|
||||
)
|
||||
|
||||
#expect(response.headers[HTTPHeaderName.sessionID] == "custom-id-abc")
|
||||
|
||||
if case .stream(let stream, _) = response {
|
||||
Task { for try await _ in stream {} }
|
||||
}
|
||||
await transport.disconnect()
|
||||
}
|
||||
|
||||
@Test("Default UUIDSessionIDGenerator produces valid session ID")
|
||||
func testDefaultGeneratorProducesUUID() async throws {
|
||||
let transport = makeStatefulTransport()
|
||||
try await transport.connect()
|
||||
|
||||
let response = await transport.handleRequest(
|
||||
makeStatefulPOSTRequest(body: makeInitializeBody())
|
||||
)
|
||||
|
||||
let sessionID = response.headers[HTTPHeaderName.sessionID]
|
||||
#expect(sessionID != nil)
|
||||
// UUID format: 8-4-4-4-12 hex chars
|
||||
if let sid = sessionID {
|
||||
#expect(sid.count == 36)
|
||||
#expect(sid.contains("-"))
|
||||
}
|
||||
|
||||
if case .stream(let stream, _) = response {
|
||||
Task { for try await _ in stream {} }
|
||||
}
|
||||
await transport.disconnect()
|
||||
}
|
||||
|
||||
// MARK: - POST Notification
|
||||
|
||||
@Test("Notification returns 202 Accepted")
|
||||
func testNotificationReturns202() async throws {
|
||||
let transport = makeStatefulTransport()
|
||||
let sessionID = try await initializeSession(transport: transport)
|
||||
|
||||
let response = await transport.handleRequest(
|
||||
makeStatefulPOSTRequest(
|
||||
body: makeNotificationBody(),
|
||||
sessionID: sessionID
|
||||
)
|
||||
)
|
||||
|
||||
#expect(response.statusCode == 202)
|
||||
await transport.disconnect()
|
||||
}
|
||||
|
||||
@Test("Notification yields to receive stream")
|
||||
func testNotificationYieldsToReceive() async throws {
|
||||
let transport = makeStatefulTransport()
|
||||
let sessionID = try await initializeSession(transport: transport)
|
||||
|
||||
let notificationBody = makeNotificationBody(method: "notifications/test")
|
||||
|
||||
// Start receiving
|
||||
let receiveTask = Task<Data?, any Error> {
|
||||
let stream = await transport.receive()
|
||||
for try await data in stream {
|
||||
// Skip init request if still in stream
|
||||
if let json = try? JSONSerialization.jsonObject(with: data) as? [String: Any],
|
||||
let method = json["method"] as? String, method == "notifications/test"
|
||||
{
|
||||
return data
|
||||
}
|
||||
}
|
||||
return nil
|
||||
}
|
||||
|
||||
// Small delay to let receive() start
|
||||
try await Task.sleep(for: .milliseconds(50))
|
||||
|
||||
_ = await transport.handleRequest(
|
||||
makeStatefulPOSTRequest(body: notificationBody, sessionID: sessionID)
|
||||
)
|
||||
|
||||
let received = try await receiveTask.value
|
||||
#expect(received != nil)
|
||||
|
||||
await transport.disconnect()
|
||||
}
|
||||
|
||||
// MARK: - POST Request/Response
|
||||
|
||||
@Test("POST request returns SSE stream")
|
||||
func testRequestReturnsSSEStream() async throws {
|
||||
let transport = makeStatefulTransport()
|
||||
let sessionID = try await initializeSession(transport: transport)
|
||||
|
||||
let response = await transport.handleRequest(
|
||||
makeStatefulPOSTRequest(
|
||||
body: makeRequestBody(id: "req-1"),
|
||||
sessionID: sessionID
|
||||
)
|
||||
)
|
||||
|
||||
#expect(response.statusCode == 200)
|
||||
if case .stream = response {
|
||||
// Expected
|
||||
} else {
|
||||
Issue.record("Expected .stream response")
|
||||
}
|
||||
|
||||
if case .stream(let stream, _) = response {
|
||||
Task { for try await _ in stream {} }
|
||||
}
|
||||
await transport.disconnect()
|
||||
}
|
||||
|
||||
@Test("Response is routed to matching request SSE stream")
|
||||
func testResponseRoutedToRequestStream() async throws {
|
||||
let transport = makeStatefulTransport()
|
||||
let sessionID = try await initializeSession(transport: transport)
|
||||
|
||||
let requestID = "route-test-1"
|
||||
|
||||
// POST a request
|
||||
let response = await transport.handleRequest(
|
||||
makeStatefulPOSTRequest(
|
||||
body: makeRequestBody(id: requestID, method: "tools/list"),
|
||||
sessionID: sessionID
|
||||
)
|
||||
)
|
||||
|
||||
guard case .stream(let stream, _) = response else {
|
||||
Issue.record("Expected .stream response")
|
||||
return
|
||||
}
|
||||
|
||||
// Collect SSE chunks in background
|
||||
let collectTask = Task {
|
||||
var chunks: [Data] = []
|
||||
for try await chunk in stream {
|
||||
chunks.append(chunk)
|
||||
}
|
||||
return chunks
|
||||
}
|
||||
|
||||
// Give stream time to start
|
||||
try await Task.sleep(for: .milliseconds(50))
|
||||
|
||||
// Consume the request from receive and send the response
|
||||
let responseBody = makeResponseBody(id: requestID)
|
||||
try await transport.send(responseBody)
|
||||
|
||||
// Collect all SSE chunks
|
||||
let chunks = try await collectTask.value
|
||||
|
||||
// Should have at least one chunk containing the response data
|
||||
let allText = chunks.map { String(decoding: $0, as: UTF8.self) }.joined()
|
||||
#expect(allText.contains("data:"))
|
||||
#expect(allText.contains(requestID))
|
||||
|
||||
await transport.disconnect()
|
||||
}
|
||||
|
||||
// MARK: - GET Stream
|
||||
|
||||
@Test("GET returns standalone SSE stream")
|
||||
func testGetReturnsSSEStream() async throws {
|
||||
let transport = makeStatefulTransport()
|
||||
let sessionID = try await initializeSession(transport: transport)
|
||||
|
||||
let response = await transport.handleRequest(
|
||||
makeGETRequest(sessionID: sessionID)
|
||||
)
|
||||
|
||||
#expect(response.statusCode == 200)
|
||||
if case .stream = response {
|
||||
// Expected
|
||||
} else {
|
||||
Issue.record("Expected .stream response for GET")
|
||||
}
|
||||
|
||||
if case .stream(let stream, _) = response {
|
||||
Task { for try await _ in stream {} }
|
||||
}
|
||||
await transport.disconnect()
|
||||
}
|
||||
|
||||
@Test("Server-initiated message routed to GET stream")
|
||||
func testServerMessageRoutedToGetStream() async throws {
|
||||
let transport = makeStatefulTransport()
|
||||
let sessionID = try await initializeSession(transport: transport)
|
||||
|
||||
// Open GET stream
|
||||
let getResponse = await transport.handleRequest(
|
||||
makeGETRequest(sessionID: sessionID)
|
||||
)
|
||||
|
||||
guard case .stream(let stream, _) = getResponse else {
|
||||
Issue.record("Expected .stream response for GET")
|
||||
return
|
||||
}
|
||||
|
||||
// Collect chunks
|
||||
let collectTask = Task {
|
||||
var chunks: [Data] = []
|
||||
for try await chunk in stream {
|
||||
chunks.append(chunk)
|
||||
// priming + message
|
||||
if chunks.count >= 2 { break }
|
||||
}
|
||||
return chunks
|
||||
}
|
||||
|
||||
try await Task.sleep(for: .milliseconds(50))
|
||||
|
||||
// Send a notification (server-initiated)
|
||||
let notification: [String: Any] = [
|
||||
"jsonrpc": "2.0",
|
||||
"method": "notifications/test",
|
||||
"params": [:] as [String: Any],
|
||||
]
|
||||
let notifData = try JSONSerialization.data(withJSONObject: notification)
|
||||
try await transport.send(notifData)
|
||||
|
||||
let chunks = try await collectTask.value
|
||||
let allText = chunks.map { String(decoding: $0, as: UTF8.self) }.joined()
|
||||
#expect(allText.contains("data:"))
|
||||
// JSONSerialization may escape "/" as "\/" in some configurations
|
||||
#expect(allText.contains("notifications/test") || allText.contains("notifications\\/test"))
|
||||
|
||||
await transport.disconnect()
|
||||
}
|
||||
|
||||
@Test("Second GET returns 409 Conflict")
|
||||
func testSecondGetReturns409() async throws {
|
||||
let transport = makeStatefulTransport()
|
||||
let sessionID = try await initializeSession(transport: transport)
|
||||
|
||||
// First GET
|
||||
let first = await transport.handleRequest(makeGETRequest(sessionID: sessionID))
|
||||
#expect(first.statusCode == 200)
|
||||
|
||||
// Second GET
|
||||
let second = await transport.handleRequest(makeGETRequest(sessionID: sessionID))
|
||||
#expect(second.statusCode == 409)
|
||||
|
||||
if case .stream(let stream, _) = first {
|
||||
Task { for try await _ in stream {} }
|
||||
}
|
||||
await transport.disconnect()
|
||||
}
|
||||
|
||||
// MARK: - DELETE
|
||||
|
||||
@Test("DELETE terminates session")
|
||||
func testDeleteTerminatesSession() async throws {
|
||||
let transport = makeStatefulTransport()
|
||||
let sessionID = try await initializeSession(transport: transport)
|
||||
|
||||
let response = await transport.handleRequest(
|
||||
makeDELETERequest(sessionID: sessionID)
|
||||
)
|
||||
|
||||
#expect(response.statusCode == 200)
|
||||
}
|
||||
|
||||
@Test("Requests after DELETE return 404")
|
||||
func testRequestsAfterDeleteReturn404() async throws {
|
||||
let transport = makeStatefulTransport()
|
||||
let sessionID = try await initializeSession(transport: transport)
|
||||
|
||||
// DELETE
|
||||
_ = await transport.handleRequest(makeDELETERequest(sessionID: sessionID))
|
||||
|
||||
// POST after delete
|
||||
let response = await transport.handleRequest(
|
||||
makeStatefulPOSTRequest(
|
||||
body: makeRequestBody(),
|
||||
sessionID: sessionID
|
||||
)
|
||||
)
|
||||
|
||||
#expect(response.statusCode == 404)
|
||||
}
|
||||
|
||||
// MARK: - Terminated State
|
||||
|
||||
@Test("All methods return 404 when terminated")
|
||||
func testAllMethodsReturn404WhenTerminated() async throws {
|
||||
let transport = makeStatefulTransport()
|
||||
let sessionID = try await initializeSession(transport: transport)
|
||||
await transport.disconnect()
|
||||
|
||||
let post = await transport.handleRequest(
|
||||
makeStatefulPOSTRequest(body: makeRequestBody(), sessionID: sessionID)
|
||||
)
|
||||
#expect(post.statusCode == 404)
|
||||
|
||||
let get = await transport.handleRequest(makeGETRequest(sessionID: sessionID))
|
||||
#expect(get.statusCode == 404)
|
||||
|
||||
let delete = await transport.handleRequest(makeDELETERequest(sessionID: sessionID))
|
||||
#expect(delete.statusCode == 404)
|
||||
}
|
||||
|
||||
// MARK: - Error Cases
|
||||
|
||||
@Test("Unsupported method returns 405")
|
||||
func testUnsupportedMethodReturns405() async throws {
|
||||
let transport = makeStatefulTransport()
|
||||
let sessionID = try await initializeSession(transport: transport)
|
||||
|
||||
let response = await transport.handleRequest(
|
||||
HTTPRequest(
|
||||
method: "PUT",
|
||||
headers: ["Mcp-Session-Id": sessionID],
|
||||
body: Data("test".utf8)
|
||||
)
|
||||
)
|
||||
|
||||
#expect(response.statusCode == 405)
|
||||
await transport.disconnect()
|
||||
}
|
||||
|
||||
@Test("Empty body returns 400")
|
||||
func testEmptyBodyReturns400() async throws {
|
||||
let transport = makeStatefulTransport()
|
||||
let sessionID = try await initializeSession(transport: transport)
|
||||
|
||||
let response = await transport.handleRequest(
|
||||
makeStatefulPOSTRequest(body: Data(), sessionID: sessionID)
|
||||
)
|
||||
|
||||
#expect(response.statusCode == 400)
|
||||
await transport.disconnect()
|
||||
}
|
||||
|
||||
@Test("Invalid JSON body returns 400")
|
||||
func testInvalidJSONReturns400() async throws {
|
||||
let transport = makeStatefulTransport()
|
||||
let sessionID = try await initializeSession(transport: transport)
|
||||
|
||||
let response = await transport.handleRequest(
|
||||
makeStatefulPOSTRequest(body: Data("not json".utf8), sessionID: sessionID)
|
||||
)
|
||||
|
||||
#expect(response.statusCode == 400)
|
||||
await transport.disconnect()
|
||||
}
|
||||
|
||||
// MARK: - Resumability
|
||||
|
||||
@Test("GET with Last-Event-ID replays stored events")
|
||||
func testGetWithLastEventIDReplaysEvents() async throws {
|
||||
let transport = makeStatefulTransport()
|
||||
let sessionID = try await initializeSession(transport: transport)
|
||||
|
||||
// POST a request to create events in the store
|
||||
let requestID = "resume-test"
|
||||
let postResponse = await transport.handleRequest(
|
||||
makeStatefulPOSTRequest(
|
||||
body: makeRequestBody(id: requestID),
|
||||
sessionID: sessionID
|
||||
)
|
||||
)
|
||||
|
||||
guard case .stream(let postStream, _) = postResponse else {
|
||||
Issue.record("Expected .stream")
|
||||
return
|
||||
}
|
||||
|
||||
// Collect the priming event to get its ID
|
||||
let eventIDHolder = ChunkCollector()
|
||||
let collectTask = Task {
|
||||
for try await chunk in postStream {
|
||||
await eventIDHolder.append(chunk)
|
||||
break // Just get the first chunk (priming)
|
||||
}
|
||||
}
|
||||
|
||||
try await Task.sleep(for: .milliseconds(50))
|
||||
|
||||
// Send the response to create a stored event
|
||||
try await transport.send(makeResponseBody(id: requestID))
|
||||
|
||||
try? await collectTask.value
|
||||
|
||||
// Parse event ID from the collected priming event
|
||||
let collectedChunks = await eventIDHolder.getChunks()
|
||||
let primingEventID: String? = collectedChunks.first.flatMap { chunk in
|
||||
let text = String(decoding: chunk, as: UTF8.self)
|
||||
guard let range = text.range(of: "id: ") else { return nil }
|
||||
let afterID = text[range.upperBound...]
|
||||
guard let newline = afterID.firstIndex(of: "\n") else { return nil }
|
||||
return String(afterID[..<newline])
|
||||
}
|
||||
|
||||
// Now try to resume with GET + Last-Event-ID
|
||||
if let eventID = primingEventID {
|
||||
let getResponse = await transport.handleRequest(
|
||||
makeGETRequest(sessionID: sessionID, lastEventID: eventID)
|
||||
)
|
||||
// Should succeed (200) and replay events
|
||||
#expect(getResponse.statusCode == 200)
|
||||
|
||||
if case .stream(let stream, _) = getResponse {
|
||||
Task { for try await _ in stream {} }
|
||||
}
|
||||
}
|
||||
|
||||
await transport.disconnect()
|
||||
}
|
||||
}
|
||||
|
||||
// MARK: - StatelessHTTPServerTransport Tests
|
||||
|
||||
@Suite("StatelessHTTPServerTransport Tests")
|
||||
struct StatelessHTTPServerTransportTests {
|
||||
|
||||
// MARK: - Lifecycle
|
||||
|
||||
@Test("Connect succeeds")
|
||||
func testConnectSucceeds() async throws {
|
||||
let transport = makeStatelessTransport()
|
||||
try await transport.connect()
|
||||
await transport.disconnect()
|
||||
}
|
||||
|
||||
@Test("Double connect throws")
|
||||
func testDoubleConnectThrows() async throws {
|
||||
let transport = makeStatelessTransport()
|
||||
try await transport.connect()
|
||||
do {
|
||||
try await transport.connect()
|
||||
Issue.record("Expected error on double connect")
|
||||
} catch {
|
||||
// Expected
|
||||
}
|
||||
await transport.disconnect()
|
||||
}
|
||||
|
||||
@Test("Send after disconnect throws connectionClosed")
|
||||
func testSendAfterDisconnectThrows() async throws {
|
||||
let transport = makeStatelessTransport()
|
||||
try await transport.connect()
|
||||
await transport.disconnect()
|
||||
do {
|
||||
try await transport.send(Data("test".utf8))
|
||||
Issue.record("Expected connectionClosed error")
|
||||
} catch let error as MCPError {
|
||||
#expect(error == .connectionClosed)
|
||||
}
|
||||
}
|
||||
|
||||
// MARK: - POST Request/Response
|
||||
|
||||
@Test("Request waits for response then returns JSON")
|
||||
func testRequestWaitsForResponse() async throws {
|
||||
let transport = makeStatelessTransport()
|
||||
try await transport.connect()
|
||||
|
||||
let requestBody = makeRequestBody(id: "42", method: "tools/list")
|
||||
let responseBody = makeResponseBody(id: "42")
|
||||
|
||||
// handleRequest blocks waiting for response
|
||||
let handleTask = Task {
|
||||
await transport.handleRequest(
|
||||
makeStatelessPOSTRequest(body: requestBody)
|
||||
)
|
||||
}
|
||||
|
||||
// Give handleRequest time to register the waiter
|
||||
try await Task.sleep(for: .milliseconds(50))
|
||||
|
||||
// Consume the request from receive and send the response
|
||||
try await transport.send(responseBody)
|
||||
|
||||
let httpResponse = await handleTask.value
|
||||
#expect(httpResponse.statusCode == 200)
|
||||
#expect(httpResponse.bodyData == responseBody)
|
||||
#expect(httpResponse.headers[HTTPHeaderName.contentType] == ContentType.json)
|
||||
|
||||
await transport.disconnect()
|
||||
}
|
||||
|
||||
@Test("Notification returns 202 Accepted")
|
||||
func testNotificationReturns202() async throws {
|
||||
let transport = makeStatelessTransport()
|
||||
try await transport.connect()
|
||||
|
||||
let response = await transport.handleRequest(
|
||||
makeStatelessPOSTRequest(body: makeNotificationBody())
|
||||
)
|
||||
|
||||
#expect(response.statusCode == 202)
|
||||
await transport.disconnect()
|
||||
}
|
||||
|
||||
@Test("Notification yields to receive stream")
|
||||
func testNotificationYieldsToReceive() async throws {
|
||||
let transport = makeStatelessTransport()
|
||||
try await transport.connect()
|
||||
|
||||
let notificationBody = makeNotificationBody(method: "notifications/test")
|
||||
|
||||
// Start receiving
|
||||
let receiveTask = Task {
|
||||
let stream = await transport.receive()
|
||||
var iterator = stream.makeAsyncIterator()
|
||||
return try await iterator.next()
|
||||
}
|
||||
|
||||
try await Task.sleep(for: .milliseconds(50))
|
||||
|
||||
_ = await transport.handleRequest(
|
||||
makeStatelessPOSTRequest(body: notificationBody)
|
||||
)
|
||||
|
||||
let received = try await receiveTask.value
|
||||
#expect(received == notificationBody)
|
||||
|
||||
await transport.disconnect()
|
||||
}
|
||||
|
||||
// MARK: - Unsupported Methods
|
||||
|
||||
@Test("GET returns 405 Method Not Allowed")
|
||||
func testGetReturns405() async throws {
|
||||
let transport = makeStatelessTransport()
|
||||
try await transport.connect()
|
||||
|
||||
let response = await transport.handleRequest(
|
||||
HTTPRequest(method: "GET", headers: ["Accept": "text/event-stream"])
|
||||
)
|
||||
|
||||
#expect(response.statusCode == 405)
|
||||
await transport.disconnect()
|
||||
}
|
||||
|
||||
@Test("DELETE returns 405 Method Not Allowed")
|
||||
func testDeleteReturns405() async throws {
|
||||
let transport = makeStatelessTransport()
|
||||
try await transport.connect()
|
||||
|
||||
let response = await transport.handleRequest(
|
||||
HTTPRequest(method: "DELETE")
|
||||
)
|
||||
|
||||
#expect(response.statusCode == 405)
|
||||
await transport.disconnect()
|
||||
}
|
||||
|
||||
// MARK: - Error Cases
|
||||
|
||||
@Test("Empty body returns 400")
|
||||
func testEmptyBodyReturns400() async throws {
|
||||
let transport = makeStatelessTransport()
|
||||
try await transport.connect()
|
||||
|
||||
let response = await transport.handleRequest(
|
||||
makeStatelessPOSTRequest(body: Data())
|
||||
)
|
||||
|
||||
#expect(response.statusCode == 400)
|
||||
await transport.disconnect()
|
||||
}
|
||||
|
||||
@Test("Invalid JSON body returns 400")
|
||||
func testInvalidJSONReturns400() async throws {
|
||||
let transport = makeStatelessTransport()
|
||||
try await transport.connect()
|
||||
|
||||
let response = await transport.handleRequest(
|
||||
makeStatelessPOSTRequest(body: Data("not json".utf8))
|
||||
)
|
||||
|
||||
#expect(response.statusCode == 400)
|
||||
await transport.disconnect()
|
||||
}
|
||||
|
||||
// MARK: - Terminated State
|
||||
|
||||
@Test("After disconnect returns 404")
|
||||
func testAfterDisconnectReturns404() async throws {
|
||||
let transport = makeStatelessTransport()
|
||||
try await transport.connect()
|
||||
await transport.disconnect()
|
||||
|
||||
let response = await transport.handleRequest(
|
||||
makeStatelessPOSTRequest(body: makeRequestBody())
|
||||
)
|
||||
|
||||
#expect(response.statusCode == 404)
|
||||
}
|
||||
|
||||
@Test("Disconnect cancels waiting requests")
|
||||
func testDisconnectCancelsWaitingRequests() async throws {
|
||||
let transport = makeStatelessTransport()
|
||||
try await transport.connect()
|
||||
|
||||
let requestBody = makeRequestBody(id: "cancel-test")
|
||||
|
||||
// Start a request that will block
|
||||
let handleTask = Task {
|
||||
await transport.handleRequest(
|
||||
makeStatelessPOSTRequest(body: requestBody)
|
||||
)
|
||||
}
|
||||
|
||||
try await Task.sleep(for: .milliseconds(50))
|
||||
|
||||
// Disconnect while request is pending
|
||||
await transport.disconnect()
|
||||
|
||||
let response = await handleTask.value
|
||||
// Should return error (500 or similar) since waiter was cancelled
|
||||
#expect(response.statusCode == 500)
|
||||
}
|
||||
}
|
||||
Loading…
Reference in a new issue