MCP Server TypeScript Starter

MCP Server TypeScript Starter

これは、TypeScript を使用して Model Context Protocol（MCP）サーバーを作成するためのスターターテンプレートです。独自の MCP サーバーの構築を始めやすいよう、サンプルツールの実装を含む基本的なセットアップを提供します。

特長

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

はじめに

独自の MCP サーバーを作成するには、次の手順に従ってください。

# Create a new directory for your project
mkdir <project_name>
cd <project_name>

# Initialize a new npm project
npm init -y

# Install dependencies
npm install @modelcontextprotocol/sdk zod
npm install -D @types/node typescript

# Create source directory and main file
mkdir src
touch src/index.ts

プロジェクト構成

.
├── src/
│   └── index.ts    # Main server implementation
├── package.json    # Project dependencies and scripts
└── tsconfig.json   # TypeScript configuration

開発

1. src/index.ts にツールを実装します
2. プロジェクトをビルドします：

   npm run build
   

新しいツールの追加

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

server.tool(
  "tool-name",
  "tool-description",
  { 
    // Define your tool's parameters using Zod schema
    param: z.string().describe("parameter description") 
  },
  async ({ param }) => {
    // Implement your tool logic here
    return {
      content: [
        {
          type: "text",
          text: `Tool executed with parameter: ${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