Unsplash MCP Server

🚀 TypeScript と MCP SDK を使用したシンプルなエコーサーバーの作成

このプロジェクトでは、TypeScript と MCP SDK を使ってシンプルなエコーサーバーを作成する方法を紹介します。エコーサーバーは、受け取った入力をそのまま返す機能を持ち、JSON-RPC 2.0 を通じて通信します。

🚀 クイックスタート

環境準備

1. Node.js と npm のインストール
   Node.js（バージョン 18 以上）と npm（Node Package Manager）をインストールし、システムにセットアップします。
2. プロジェクトディレクトリの作成

   mkdir my-mcp-server
   cd my-mcp-server
   

3. Node.js プロジェクトの初期化

   npm init -y
   

4. MCP TypeScript SDK のインストール

   npm install @modelcontextprotocol/sdk
   

5. TypeScript とその他の依存関係のインストール

   npm install typescript zod
   

6. tsconfig.json ファイルの作成

   {
     "compilerOptions": {
       "target": "ES2020",
       "module": "NodeNext",
       "esModuleInterop": true,
       "forceConsistentCasingInFileNames": true,
       "strict": true,
       "skipLibCheck": true,
       "outDir": "./build"
     },
     "include": ["src/**/*"]
   }
   

7. src ディレクトリと index.ts ファイルの作成

   mkdir src
   touch src/index.ts
   

MCP SDK を使用したサーバーの作成

src/index.ts ファイルに以下の内容を追加して、シンプルなエコーサーバーを作成します。

#!/usr/bin/env node

import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
import { z } from 'zod';

// MCP サーバーインスタンスの作成
const server = new McpServer({
  name: 'EchoServer',
  version: '1.0.0',
});

// エコーツールの追加：入力をそのまま返す
server.tool(
  'echo',
  { message: z.string() }, // 入力の Zod スキーマを定義
  async ({ message }) => ({
    content: [{ type: 'text', text: `Echo: ${message}` }],
  })
);

// トランスポートインスタンスの作成（この例では Stdio トランスポートを使用）
const transport = new StdioServerTransport();

// サーバーとトランスポート層の接続
await server.connect(transport);

コンパイルと実行

1. TypeScript コードのコンパイル

   npx tsc
   

2. コンパイルされた JavaScript ファイルの実行

   node build/index.js
   

3. package.json に以下のスクリプトを追加します。

   "scripts": {
     "build": "tsc && node -e \"require('fs').chmodSync('build/index.js', '755')\"",
     "start": "node build/index.js"
   }
   

   これで、以下のコマンドでサーバーを起動できます。

   npm run build
   npm start
   

エコー機能のテスト

サーバーに有効な JSON-RPC 2.0 リクエストを送信して、エコーツールをテストします。例えば：

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": { "name": "echo", "arguments": { "message": "Hello, world!" } }
}

サーバーは以下のように返信します。

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "Echo: Hello, world!"
      }
    ]
  }
}