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

TypeScriptを使用してモデルコンテキストプロトコル（MCP）サーバーを作成するためのテンプレートです。このプロジェクトでは、カスタムツールを使用してシンプルなMCPサーバーを実装する方法を示します。

概要

このテンプレートは、次のツールを提供する基本的な MCP サーバーを実装します。

操作例: 簡単なデモ操作
加算: 2つの数字を足すツール

サーバーは、モデルコンテキストプロトコル SDK を使用して、AI モデルと外部ツール間の通信を処理します。

Related MCP server: MCP Server Template

前提条件

Node.js (v16 以上)
npmまたはyarn

プロジェクト構造

プロジェクトは次のように構成されています。

mcp-server-typescript-template/
├── common/
│   ├── constant.ts     # Project constants
│   ├── errors.ts       # Error handling utilities
│   └── types.ts        # Type definitions
│   └── utils.ts        # Utility functions

├── operations/
│   └── example-operation.ts  # Implementation of example operations
├── index.ts            # Main server implementation
├── package.json
└── tsconfig.json

インストール

リポジトリをクローンし、依存関係をインストールします。

git clone <repository-url>
cd mcp-server-typescript-template
npm install
npm run test
npm run build
npm run start # this will start the server for testing

MCP クライアントの構成 (Claude デスクトップ)

claude_desktop_config.jsonファイルを編集して、以下を追加します。

{
  "mcpServers": {
    "example": {
      "command": "node",
      "args": [
        "/path/to/mcp-server-typescript-template/dist/index.js"
      ]
    }
  }
}