MCP Server Template

🚀 MCP サーバーテンプレート

このテンプレートは、TypeScript と Node.js を使用して、Model Context Protocol (MCP) サーバーを構築するための包括的な解決策を提供します。

🚀 クイックスタート

通常のクイックスタート

# このリポジトリをクローンする
git clone https://github.com/your-org/mcp-server-template.git my-mcp-server

# プロジェクトディレクトリに移動する
cd my-mcp-server

# 依存関係をインストールする
npm install

# プロジェクトをビルドする
npm run build

# サンプルサーバーを起動する
npm start

LLMs との連携でのクイックスタート

このテンプレートは、AI アシスタント（Claude など）を使用して MCP サーバーを開発する際に、シームレスに統合できるように設計されています。

1. このリポジトリをクローンする：

   git clone https://github.com/your-org/mcp-server-template.git my-mcp-server
   cd my-mcp-server
   

2. 依存関係をインストールする：

   npm install
   

3. PROMPT_TEMPLATE.md または AI_ASSISTANT_PROMPT.md のプロンプトをコピーし、Claude または他の LLM との会話に貼り付けます。

4. 特定の MCP サーバーの要件の詳細を記入します。

5. LLM を使用して、カスタムツール、リソース、その他の機能を実装します。

6. 含まれているテストツールを使用してテストを行います：

   npm test
   

7. 必要に応じて MCP サーバーをデプロイします。

✨ 主な機能

MCP サーバーの実装

このテンプレートには、次の機能を備えた基本的な MCP サーバーの実装が含まれています。

• プロトコルバージョンの協議
• 機能宣言
• ツールの登録と実行
• リソース管理
• エラー処理
• ロギング

ツールとリソース

サンプル実装には、以下が含まれています。

• 基本的なツールとそのパラメーター検証
• URI テンプレートを使用したリソース定義
• プロンプトテンプレート

テスト

このテンプレートには、以下のためのテストフレームワークが含まれています。

• ツールとリソースの単体テスト
• MCP クライアントとの統合テスト
• 外部依存関係のモック

📦 インストール

上述の「クイックスタート」セクションを参照してください。

📚 ドキュメント

docs/ ディレクトリには、詳細なドキュメントが含まれています。

🔧 開発ルール

コードの貢献方法については、DEVELOPMENT_RULES.md のガイドラインに従ってください。

💻 使用例

examples/ ディレクトリのサンプル実装を参照して、MCP サーバーテンプレートの使い方を学ぶことができます。

🤝 貢献ガイド

プロジェクトへの貢献方法については、CONTRIBUTING.md を読んでください。

📁 ディレクトリ構造

mcp-server-template/
├── package.json           # ES モジュールとしての設定
├── tsconfig.json          # TypeScript の設定
├── README.md              # ドキュメントと使用例
├── PROMPT_TEMPLATE.md     # タスク固有の LLM アシスタント用のテンプレート
├── AI_ASSISTANT_PROMPT.md # MCP の専門知識を持った AI アシスタントのロールプロンプト
├── DEVELOPMENT_RULES.md   # 開発ガイド
├── src/
│   ├── index.ts           # メインサーバーの実装
│   ├── tools/             # サンプルツールの実装
│   │   └── example-tool.ts
│   ├── resources/         # サンプルリソースの実装
│   │   └── example-resource.ts
│   └── utils/             # ユーティリティツール
│       └── error-handling.ts
├── tests/                 # テストスクリプト
│   └── server.test.js
├── docs/                  # 詳細なドキュメント
│   ├── client-developers.md
│   ├── server-developers.md
│   ├── claude-users.md
│   └── mcp-reference.md
└── examples/              # サンプル実装
    ├── weather-server/    # 国家気象局 API のサンプル
    ├── github-server/     # GitHub API のサンプル
    └── local-files-server/ # ローカルファイルシステムのサンプル