MCP Swift Example Server

What is MCP Swift Example Server?

A basic example server demonstrating how to create a simple Model Context Protocol (MCP) server using the Swift MCP SDK. It communicates over standard input/output (stdio) and is compatible with applications like Claude Desktop.

How to use MCP Swift Example Server?

Clone the repository, build with swift build -c release, then add the absolute path to the compiled executable to your claude_desktop_config.json under mcpServers. An optional client example is available in the Examples directory.

Key features of MCP Swift Example Server

• Sets up a basic MCP server using the Swift SDK
• Defines and registers a custom tool (swift_echo)
• Handles ListTools and CallTool requests
• Uses StdioTransport for communication
• Detailed logging to stderr

Use cases of MCP Swift Example Server

• Learning how to build an MCP server in Swift
• Testing the MCP protocol with a simple echo tool
• Integrating custom tools into Claude Desktop
• Experimenting with the Swift MCP SDK

FAQ from MCP Swift Example Server

What are the runtime requirements?

macOS 13 or later and Swift 5.9 or later are required.

How does the server communicate?

It communicates over standard input/output (stdio) using the StdioTransport.

What tool does this server provide?

It provides a single tool named swift_echo, which echoes input back to the caller.

How do I configure Claude Desktop to use this server?

Add an entry to your claude_desktop_config.json with the server name and the absolute path to the compiled executable as the command.

Where is the source code located?

The project structure includes main.swift (entry point), MCPServer (protocol implementation), and EchoToolbox (tool provider).