MCP Server Starter Typescript

🚀 MCP サーバー TypeScript 起動テンプレート

このテンプレートは、モデルコンテキストプロトコル (MCP) サーバーを作成するための TypeScript の起動テンプレートです。基本的な設定とサンプルツールの実装を提供し、MCP サーバーの構築を迅速に開始するのに役立ちます。

✨ 主な機能

• TypeScript の設定
• 基本的な MCP サーバー設定
• サンプルツールの実装
• 型安全な開発環境

🚀 クイックスタート

以下の手順に従って、あなたの MCP サーバーを作成しましょう。

# プロジェクトディレクトリを作成
mkdir <project_name>
cd <project_name>

# 新しい npm プロジェクトを初期化
npm init -y

# 依存関係をインストール
npm install @modelcontextprotocol/sdk zod
npm install -D @types/node typescript

# ソースコードディレクトリとメインファイルを作成
mkdir src
touch src/index.ts

📁 プロジェクト構造

.
├── src/
│   └── index.ts    # メインサーバーの実装
├── package.json    # プロジェクトの依存関係とスクリプト
└── tsconfig.json   # TypeScript の設定

💻 開発

1. src/index.ts であなたのツールを実装します。
2. プロジェクトをビルドします。

   npm run build
   

➕ 新しいツールの追加

新しいツールを追加するには、server.tool() メソッドを使用します。例：

server.tool(
  "tool-name",
  "tool-description",
  { 
    // Zod スキーマを使用してツールのパラメータを定義
    param: z.string().describe("parameter description") 
  },
  async ({ param }) => {
    // ここでツールのロジックを実装
    return {
      content: [
        {
          type: "text",
          text: `ツールはパラメータ: ${param} で実行されました`,
        },
      ],
    };
  },
);

⚙️ MCP サーバーの設定

プロジェクト内で複数の MCP サーバーを設定することができます。以下は設定例です。

{
    "mcpServers": {
        "<server_name>": {
            "command": "<command>",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/<project_name>",
                "run",
                "<script_name>"
            ]
        }
    }
}

この設定で指定される項目は次の通りです。

• <server_name>：MCP サーバーの一意の識別子
• command：スクリプトを実行するコマンド（例：python, node, uv）
• args：コマンドライン引数の配列
  • --directory：スクリプトの作業ディレクトリを設定
  • あなたのコマンドとスクリプトの要件に合わせた特定の引数

mcpServers オブジェクトにさらにエントリを追加することで、より多くのサーバー設定を追加できます。

📄 ライセンス

ISC