当前位置：首页 > news >正文

编写第一个MCP Server之Hello world

news 2025/5/12 10:19:18

引言

上一篇《在Cline上调用MCP服务之MCP实践篇》我们讲到如何调用MCP服务，这次我们就来自己写一个MCP服务。

在动手自己编写MCP Server之前建议还是先认真看一遍MCP官网的介绍。
在这里插入图片描述

参考官方教程，我们计划编写一个名为“Echo”的MCP Server作为我们的MCP Server Hello world。

一、检查环境并初始化项目

首先我们要检查环境。对于本教程，您需要 Node.js 版本 16 或更高版本。

node --version
npm --version

现在，让我们创建并设置我们的项目：

# Window 的命令如下
# Create a new directory for our project
md echo
cd echo# Initialize a new npm project
npm init -y# Install dependencies
npm install @modelcontextprotocol/sdk zod
npm install -D @types/node typescript# Create our files
md src
new-item src\index.ts

在这里插入图片描述
继续敲命令。

此时看一眼文件目录。

看看接下来我都遇到了什么。

换到powershell执行，OK了。此时index.ts文件为空。

更新您的 package.json 以添加 type： “module” 和构建脚本：

{"name": "echo","version": "1.0.0","main": "index.js","scripts": {"build": "tsc && chmod 755 build/index.js","prepare": "npm run build","dev": "tsc --watch","start": "node build/index.js","test": "echo \"Error: no test specified\" && exit 1"},"keywords": [],"author": "","license": "ISC","description": "","dependencies": {"@modelcontextprotocol/sdk": "^1.11.1","zod": "^3.24.4"},"devDependencies": {"@types/node": "^22.15.17","typescript": "^5.8.3"},"type": "module","bin": {"echo": "./build/index.js"},"files": ["build"]
}

在项目的根目录中创建一个 tsconfig.json：

{"compilerOptions": {"target": "ES2022","module": "Node16","moduleResolution": "Node16","outDir": "./build","rootDir": "./src","strict": true,"esModuleInterop": true,"skipLibCheck": true,"forceConsistentCasingInFileNames": true},"include": ["src/**/*"],"exclude": ["node_modules"]
}

二、构建MCP服务器

现在让我们开始构建您的服务器。
在src/index.ts文件导入包并设置server实例。

import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
import { z } from "zod";const server = new McpServer({name: "Echo",version: "1.0.0"
});server.tool("echo",{ message: z.string() },async ({ message }) => ({content: [{ type: "text", text: `Tool echo: ${message}` }]})
);server.prompt("echo",{ message: z.string() },({ message }) => ({messages: [{role: "user",content: {type: "text",text: `Please process this message: ${message}`}}]})
);

最后，实现 main 函数来运行服务器：

async function main() {const transport = new StdioServerTransport();await server.connect(transport);console.error("echo MCP Server running on stdio");
}main().catch((error) => {console.error("Fatal error in main():", error);process.exit(1);
});

确保运行 npm run build 来构建您的服务器！这是让您的服务器连接非常重要的步骤。

但是提示这个玩意。也是，chomd 是属于Linux下的命令。
在这里插入图片描述
尝试换一下命令，并可以手动赋予编译文件权限（其实不操作问题也不大）。

{"name": "echo","version": "1.0.0","main": "index.js","scripts": {"build": "tsc","prepare": "npm run build","dev": "tsc --watch","start": "node build/index.js","test": "echo \"Error: no test specified\" && exit 1"},"keywords": [],"author": "","license": "ISC","description": "","dependencies": {"@modelcontextprotocol/sdk": "^1.11.1","zod": "^3.24.4"},"devDependencies": {"@types/node": "^22.15.17","typescript": "^5.8.3"},"type": "module","bin": {"echo": "./build/index.js"},"files": ["build"]
}