Unsplash MCP Server

🚀 使用 TypeScript 和 MCP SDK 創建簡單的回顯服務器

本項目藉助 TypeScript 和 MCP SDK 構建了一個簡單的回顯服務器，能將接收到的消息原樣返回，可用於快速測試和驗證消息傳輸功能。

🚀 快速開始

環境準備

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!"
      }
    ]
  }
}