TypeScript MCP Demo Server

TypeScript MCP デモサーバー

TypeScript SDK と Bun ランタイムを使用した、基本的な Model Context Protocol（MCP）サーバーの実装です。

概要

このプロジェクトでは、以下の機能を備えた TypeScript による MCP サーバーの構築方法を紹介します。

• stdio トランスポートによるサーバーの初期化
• ツールの登録と処理
• TypeScript の型安全性
• 高速な実行を実現する Bun ランタイム

前提条件

• Bun（最新バージョン）
• Task（任意。タスクランナーとして使用）

インストール

# Clone the repository
git clone https://github.com/gedankrayze/ts-demo-mcp.git
cd ts-demo-mcp

# Install dependencies
bun install

プロジェクト構成

ts-demo-mcp/
├── src/
│   └── index.ts        # Main MCP server implementation
├── package.json        # Project dependencies and scripts
├── tsconfig.json       # TypeScript configuration
├── Taskfile.yaml       # Task runner configuration
└── README.md          # This file

利用可能なツール

このサーバーには、2 つのツールの例が実装されています。

1. greet

ユーザーの名前を使って挨拶します。

入力スキーマ：

{
  "name": "string"  // Required: The name of the person to greet
}

応答例：

Hello, John! Welcome to the TypeScript MCP demo server.

2. add_numbers

2 つの数値を足します。

入力スキーマ：

{
  "a": "number",  // Required: The first number
  "b": "number"   // Required: The second number
}

応答例：

The sum of 5 and 3 is 8.

使用方法

npm/bun スクリプトを使用する場合

# Start the MCP server
bun start

# Run TypeScript type checking
bun typecheck

Task ランナーを使用する場合

# Start the MCP server
task start

# Inspect server capabilities with MCP inspector
task inspect-server

# Send a raw initialization request
task inspect

Claude Desktop との連携

このサーバーを Claude Desktop で使用するには、以下を Claude Desktop の設定に追加します。

{
  "mcpServers": {
    "ts-demo-mcp": {
      "command": "bun",
      "args": ["run", "/path/to/ts-demo-mcp/src/index.ts"]
    }
  }
}

開発

新しいツールの追加

サーバーに新しいツールを追加するには、以下の手順に従います。

1. ListToolsRequestSchema ハンドラーのツールリストを更新します
2. CallToolRequestSchema ハンドラーにツールの実装を追加します

例：

// In ListToolsRequestSchema handler
{
  name: "my_tool",
  description: "Description of what the tool does",
  inputSchema: {
    type: "object",
    properties: {
      param1: { type: "string", description: "Parameter description" }
    },
    required: ["param1"]
  }
}

// In CallToolRequestSchema handler
case "my_tool": {
  const param1 = request.params.arguments?.param1 as string;
  return {
    content: [{
      type: "text",
      text: `Tool output for ${param1}`
    }]
  };
}

型チェック

このプロジェクトでは、厳格モードを有効にした TypeScript を使用しています。次のコマンドで型チェックを実行します。

bun typecheck

MCP Inspector

このプロジェクトには、デバッグ用の MCP Inspector が含まれています。これを使って、サーバーの機能を確認できます。

task inspect-server

これにより、MCP サーバーをテストするためのインタラクティブな Web インターフェースが起動します。

ライセンス

このプロジェクトは公開されており、https://github.com/gedankrayze/ts-demo-mcp で利用できます。

リソース

• Model Context Protocol のドキュメント
• MCP TypeScript SDK
• Bun のドキュメント