A
security-
licenseA
qualityA production-ready template for creating Model Context Protocol servers with TypeScript, providing tools for efficient testing, development, and deployment.
Last updated -
1
158
38
MIT License
MCP サーバー テンプレート
TypeScriptでモデルコンテキストプロトコル（MCP）サーバーを作成するためのテンプレートです。このテンプレートは、適切なツール、型安全性、そしてベストプラクティスを用いて、MCP互換サーバーを構築するための強固な基盤を提供します。
特徴
🚀 TypeScriptの完全サポート
🏗️ コンテナベースの依存性注入
📦 DataProcessor インターフェースを使用したサービスベースのアーキテクチャ
🛠️ テストを含むツール実装の例
🧪 Vitest テストフレームワーク
📝 型定義
🔌 MCP SDK 統合
はじめる
発達
依存関係をインストールします:
npm installホット リロードで開発サーバーを起動します。
npm run devプロジェクトをビルドします。
npm run buildテストを実行します:
npm test本番サーバーを起動します。
npm start
プロジェクト構造
src/
├── index.ts # Entry point
├── interfaces/ # Interface definitions
│ └── tool.ts # DataProcessor interface
└── tools/ # Tool implementations
└── example.ts # Example tool
ツールの作成
src/tools/example.tsの例に従って、ツールとハンドラーをエクスポートします。// In your-tool.ts export const YOUR_TOOLS = [ { name: "your-tool-name", description: "Your tool description", parameters: { // Your tool parameters schema }, }, ]; export const YOUR_HANDLERS = { "your-tool-name": async (request) => { // Your tool handler implementation return { toolResult: { content: [{ type: "text", text: "Result" }], }, }; }, };src/index.tsのALL_TOOLSおよびALL_HANDLERS定数にツールを登録します。// In src/index.ts import { YOUR_TOOLS, YOUR_HANDLERS } from "./tools/your-tool.js"; // Combine all tools const ALL_TOOLS = [...EXAMPLE_TOOLS, ...YOUR_TOOLS]; const ALL_HANDLERS = { ...EXAMPLE_HANDLERS, ...YOUR_HANDLERS };
サーバーは自動的に次の処理を実行します。
利用可能なツールにツールをリストします
入力検証を処理する
ツールへのリクエストを処理する
MCPプロトコルに従って応答をフォーマットする
テスト
テンプレートには、ローカル テスト用の組み込み TestClient と視覚的なデバッグ用の MCP Inspector が含まれています。
TestClientの使用
TestClient はツールをテストする簡単な方法を提供します。
import { TestClient } from "./utils/TestClient";
describe("YourTool", () => {
const client = new TestClient();
it("should process data correctly", async () => {
await client.assertToolCall(
"your-tool-name",
{ input: "test" },
(result) => {
expect(result.toolResult.content).toBeDefined();
}
);
});
});
MCPインスペクターの使用
テンプレートには、ツールを視覚的にデバッグするための MCP インスペクターが含まれています。
インスペクターを起動します。
npx @modelcontextprotocol/inspector node dist/index.jshttp://localhost:5173でインスペクターUIを開きます。
検査官は以下を提供します:
テストツールのビジュアルインターフェース
リアルタイムのリクエスト/レスポンス監視
ツールメタデータ検査
インタラクティブなテスト環境
カーソルを使ったローカルテスト
Cursor を使用して MCP サーバーをローカルでテストするには:
パッケージをビルドしてリンクします。
npm run build npm run linkバイナリが動作することを確認します。
npx example-mcp-toolカーソルにサーバーを追加します。
カーソル設定を開く
機能タブに移動します
MCPサーバーのセクションまでスクロールします
「サーバーを追加」をクリックします
「コマンド」タイプを選択
名前を付けます（例：「ローカルサンプルツール」）
次のコマンドを入力します:
npx example-mcp-tool確認をクリック
MCP サーバー セクションでサーバーが実行中であることが表示されていることを確認し、カーソルでサーバーが正しく起動していることを確認します。
注意: コードを変更した場合は、必ず再構築して再リンクしてください。
npm run build
npm run link
テストが完了したら、パッケージのリンクを解除できます。
npm run unlink
これにより、開発中に作成されたグローバル シンボリック リンクが削除されます。
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
依存性注入やサービスベースのアーキテクチャなどの機能を備えたモデルコンテキストプロトコルサーバーを開発するための TypeScript ベースのテンプレートで、カスタムデータ処理ツールの作成と統合を容易にします。
Related Resources
Related MCP Servers
- Asecurity-licenseAqualityA template for creating Model Context Protocol (MCP) servers in TypeScript, offering features like container-based dependency injection, a service-based architecture, and integration with the LLM CLI for architectural design feedback through natural language.Last updated -117
- Asecurity-licenseAqualityA TypeScript-based template for building Model Context Protocol servers, featuring fast testing, automated version management, and a clean structure for MCP tool implementations.Last updated -11584MIT License
- -security-license-qualityA starter template for creating Model Context Protocol servers using TypeScript, providing basic setup and sample tool implementation for developers to build their own MCP servers.