从零搭建你的第一个 MCP 服务器,并接入 ChatGPT
手把手教你安装环境、创建 MCP 服务器、本地测试并发布到 ChatGPT,适合零基础读者。
准备环境
在开始前,你需要安装以下工具:
- Node.js:一个让 JavaScript 在电脑上运行的环境。去 nodejs.org 下载 LTS 版本并安装。
- Git:版本控制工具,用于管理代码。从 git-scm.com 下载安装。
- 代码编辑器:推荐 VS Code,从 code.visualstudio.com 下载。
另外,你需要一个 Supabase 账号(免费)用于数据库和登录功能,以及一个 DigitalOcean 账号(可选,用于部署)。但本教程只聚焦本地搭建,部署部分可后续学习。
安装步骤
- 打开终端(Mac 的“终端”或 Windows 的“命令提示符”),创建一个新文件夹:
mkdir mcp_todo并进入:cd mcp_todo。 - 初始化 npm 项目:
npm init --init-type=module -y。这会生成package.json,支持 ES6 模块。 - 初始化 Git:
git init。 - 安装依赖包:
npm install @modelcontextprotocol/sdk zod @supabase/supabase-js。其中 @modelcontextprotocol/sdk 是 MCP 服务器官方开发工具包;zod 用于验证 AI 传入的数据;@supabase/supabase-js 用于连接数据库。 - 创建
.gitignore文件,写入node_modules,防止这些文件被 Git 追踪。 - 运行
git add .和git commit -m "Initial commit"保存当前状态。
创建并测试你的第一个 MCP 服务器
- 在项目文件夹中新建
server.js文件,用编辑器打开。 - 粘贴以下基础代码(这是最简单的 MCP 服务器,返回“Hello World”):
import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js"; import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"; const server = new McpServer({ name: "TodoServer", version: "1.0.0" }); server.tool( "hello", { name: { type: "string" } }, async ({ name }) => ({ content: [{ type: "text", text: `Hello, ${name}!` }] }) ); const transport = new StdioServerTransport(); await server.connect(transport); - 保存文件,在终端运行:
node server.js。此时服务器不会输出任何内容,因为它等待 AI 客户端连接。 - 安装 MCP Inspector 测试工具:
npx @modelcontextprotocol/inspector node server.js。浏览器会打开一个界面,点击“Connect”,然后调用“hello”工具,传入参数{"name":"World"},你会看到返回Hello, World!。
下一步可以做什么
你已经成功跑通了第一个 MCP 服务器!接下来可以:
- 添加更多工具(如待办事项增删查改)。
- 集成 Supabase 数据库保存数据。
- 添加用户登录功能。
- 部署到 DigitalOcean 并发布到 ChatGPT 应用商店。
记住:每个新功能都先在小范围内测试,逐步扩展。遇到问题多查官方文档或社区教程。
内容来源
freeCodeCamp
发布时间
2026-07-12 01:30