MCP Template

Name: MCP Template
Author: adamwulf

@adamwulf

リポジトリホームページ

MCP Template について

A barebones MCP server implementation in Swift using loopwork-ai's mcp-swift-sdk.

#swift #mcp #cursor #claude

基本情報

カテゴリ

開発者ツール

ライセンス

MIT

ランタイム

swift

トランスポート

stdio

公開者

adamwulf

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "mcp-template": {
      "command": "npx",
      "args": [
        "@modelcontextprotocol/inspector",
        "<absolute_path_to_your_executable>",
        "run"
      ]
    }
  }
}

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is MCP Template?

MCP Template is a barebones foundation for building Model Context Protocol (MCP) servers using Swift. It demonstrates minimal integration with the mcp-swift-sdk and is intended for macOS applications and command line tools.

How to use MCP Template?

Add the package to your Package.swift dependencies, then import EasyMCP to register tools and start the server. The included command-line executable mcpexample offers a hello command for a basic demo and a run command to start a full MCP server with stdio transport. For debugging, use the MCP Inspector by running npx @modelcontextprotocol/inspector <path_to_executable> run.

Key features of MCP Template

Basic Swift package structure for MCP server projects
Command line "hello world" example tool
Command line stdio transport for MCP interaction via run command
Planned: App Store safe stdio and SSE server support
Simple tool registration with async closures and error handling

Use cases of MCP Template

Starting point for implementing custom MCP servers in Swift
Learning the basics of MCP integration with mcp-swift-sdk
Building command-line tools that communicate via MCP protocol
Prototyping MCP resources and tools for macOS applications
Foundation for debugging MCP implementations with the MCP Inspector

FAQ from MCP Template

What is the purpose of MCP Template?

It serves as a reference implementation and template that can be forked or cloned to jumpstart your own MCP server development, showing how to use mcp-swift-sdk in a minimal way.

What dependencies does MCP Template require?

It requires swift-argument-parser 1.3.0+ and a custom fork of mcp-swift-sdk (branch "feature/wait-for-complete").

What transport protocols does MCP Template support?

Currently it supports stdio transport for MCP interaction. SSE (Server-Sent Events) support is planned but not yet implemented.

What are the current limitations of MCP Template?

It is a barebones example with only a "hello world" tool; SSE server and App Store safe stdio communication are not yet available. It targets macOS and uses a custom SDK fork.

How can I debug my MCP server built with this template?

Build the executable in Xcode, locate it via Product → Show Build Folder, then run the MCP Inspector with npx @modelcontextprotocol/inspector <path> run. Attach the debugger in Xcode to step through breakpoints.