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