mcp-server-starter

PythonでModel Context Protocol (MCP) サーバーを構築するためのスケルトンです。Claude Desktop、Claude Code、またはその他のMCP互換クライアントにカスタムツールやデータセットを公開する必要がある場合に、このリポジトリをフォークしてください。

MCPサーバーとは？

MCPは、言語モデルクライアントが標準インターフェースを通じて外部ツールやデータソースを呼び出せるようにするオープンプロトコルです。MCPサーバーはそれらのツールをホストする小さなプロセスです。あなたが関数を記述すれば、プロトコルが検出と呼び出しを処理します。

クイックスタート

pipxを使用して、このリポジトリから直接インストールします：

pipx install git+https://github.com/roderickch01/mcp-server-starter.git

次に、MCPクライアントに登録します。Claude Desktopの場合は、~/.config/Claude/claude_desktop_config.json (Linux)、~/Library/Application Support/Claude/claude_desktop_config.json (macOS)、または %APPDATA%\Claude\claude_desktop_config.json (Windows) を編集し、以下を追加します：

{
  "mcpServers": {
    "starter": {
      "command": "mcp-server-starter"
    }
  }
}

このスニペットのコピーは examples/claude_desktop_config.json にあります。クライアントを再起動すると、echo および add ツールが表示されるはずです。

含まれているもの

接続を確認するための2つのデモツール：

echo(text: str) -> str — "echo: {text}" を返します
add(a: int, b: int) -> int — 合計を返します

どちらも src/mcp_server_starter/server.py （30行未満）に記述されています。

独自のツールの追加

server.py を開き、任意の関数に @mcp.tool() デコレータを付けます。関数のシグネチャ、型ヒント、およびドキュメント文字列が自動的にツールのスキーマになります：

@mcp.tool()
def reverse(text: str) -> str:
    """Return the input string reversed."""
    return text[::-1]

再インストール (pipx reinstall mcp-server-starter) してMCPクライアントを再起動してください。新しいツールが検出可能になります。

ローカル開発

git clone https://github.com/roderickch01/mcp-server-starter.git
cd mcp-server-starter
python -m venv .venv && source .venv/bin/activate
pip install -e .
mcp-server-starter   # runs the server over stdio