mcp-server-template

コーディングエージェントが実際にうまく使える読み取り専用のMCPサーバーを構築するための、設計思想が明確なテンプレート：タイムアウト付きのI/Oシーム、オフラインテスト、コンパクトなテキスト出力、最小権限のドキュメント。

ここから始める → BUILDING.md — アイデアからサーバー公開までの完全なワークフロー（約半日）。

含まれるもの：動作するサンプルサーバー（pypi_project：スタブ化されたシームの背後にある固定オリジンHTTPツール ＋ word_stats：純粋なツール）、オフラインのテストスイート、CIワークフロー、CLAUDE.md の規約、下記のREADMEスケルトン。

ネットワークの例は、意図的に任意のURLを受け付けません。「読み取り専用」は、URLフェッチャーを安全にするわけではありません：制限のない宛先やリダイレクトの追跡は、ループバック、プライベートネットワーク、クラウドメタデータサービスを露出させる可能性があります。pypi_project は https://pypi.org/... リクエストのみを構築し、URL/パス形式の入力を拒否し、リダイレクトを一切追跡せず、デコード後のレスポンスを2 MiBに制限し、操作全体に15秒の期限を適用します。

サーバー用のREADMEスケルトン（このファイル全体を置き換えてください）

1. # mcp-<name> ＋ 太字で1行のバリュープロポジション

2. 4行の使用例トランスクリプト（You: … / Agent: → ツール呼び出し / Agent: 回答）

3. ツールテーブル（ツール → 返す内容）

4. インストール：claude mcp add <name> -e TOKEN=... -- python -m mcp_<name> ＋ .mcp.json ブロック

5. トークンのスコープ / セキュリティ（最小権限、読み取り専用の明記）

6. 設計メモ（なぜ読み取り専用か、なぜコンパクトなテキストか、なぜタイムアウトか）

7. ライセンス ＋ 連絡先

上記の構造をそのまま使用し、派生サーバーを公開する前にすべてのテンプレート名と例を置き換えてください。

Related MCP server: MCP Server Template

セキュリティとプライバシー

• この例は、指定されたパッケージ名のみをPyPIに送信します。ツールの引数にシークレットや非公開の識別子を入れないでください。

• PyPIのプロジェクト概要はアップロード者が管理する散文であり、この例ではエージェントから見える出力から意図的に除外しています。すべての外部テキストは信頼できないデータとして扱ってください。

• 認証情報、認可ヘッダー、生の非公開レスポンス、ユーザープロンプトを決してログに記録しないでください。

• 各引数がどの外部サービスに送信されるかを文書化してください。非公開のCIログや内部URLは、ツールが読み取りのみを行う場合でも機密情報です。

• 宛先の許可リストと、リダイレクトやDNSリバインディングではバイパスできないトランスポートを実装しない限り、派生サーバーに任意のURLフェッチを含めないでください。

開発

python -m pip install -e ".[dev]"
ruff check . && ruff format --check .
pytest
python -m build

MIT — LICENSE を参照してください。