极客前沿

从零搭建你的第一个 MCP 服务器,并接入 ChatGPT

2026-07-12 01:30
freeCodeCamp
查看原文

手把手教你安装环境、创建 MCP 服务器、本地测试并发布到 ChatGPT,适合零基础读者。

准备环境

在开始前,你需要安装以下工具:

Tutorial Image
  • Node.js:一个让 JavaScript 在电脑上运行的环境。去 nodejs.org 下载 LTS 版本并安装。
  • Git:版本控制工具,用于管理代码。从 git-scm.com 下载安装。
  • 代码编辑器:推荐 VS Code,从 code.visualstudio.com 下载。

另外,你需要一个 Supabase 账号(免费)用于数据库和登录功能,以及一个 DigitalOcean 账号(可选,用于部署)。但本教程只聚焦本地搭建,部署部分可后续学习。

Tutorial Image

安装步骤

  1. 打开终端(Mac 的“终端”或 Windows 的“命令提示符”),创建一个新文件夹:mkdir mcp_todo 并进入:cd mcp_todo
  2. 初始化 npm 项目:npm init --init-type=module -y。这会生成 package.json,支持 ES6 模块。
  3. 初始化 Git:git init
  4. 安装依赖包:npm install @modelcontextprotocol/sdk zod @supabase/supabase-js。其中 @modelcontextprotocol/sdk 是 MCP 服务器官方开发工具包;zod 用于验证 AI 传入的数据;@supabase/supabase-js 用于连接数据库。
  5. 创建 .gitignore 文件,写入 node_modules,防止这些文件被 Git 追踪。
  6. 运行 git add .git commit -m "Initial commit" 保存当前状态。

创建并测试你的第一个 MCP 服务器

  1. 在项目文件夹中新建 server.js 文件,用编辑器打开。
  2. 粘贴以下基础代码(这是最简单的 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);
  3. 保存文件,在终端运行:node server.js。此时服务器不会输出任何内容,因为它等待 AI 客户端连接。
  4. 安装 MCP Inspector 测试工具:npx @modelcontextprotocol/inspector node server.js。浏览器会打开一个界面,点击“Connect”,然后调用“hello”工具,传入参数 {"name":"World"},你会看到返回 Hello, World!

下一步可以做什么

你已经成功跑通了第一个 MCP 服务器!接下来可以:

Tutorial Image
  • 添加更多工具(如待办事项增删查改)。
  • 集成 Supabase 数据库保存数据。
  • 添加用户登录功能。
  • 部署到 DigitalOcean 并发布到 ChatGPT 应用商店。

记住:每个新功能都先在小范围内测试,逐步扩展。遇到问题多查官方文档或社区教程。

内容来源

freeCodeCamp

发布时间

2026-07-12 01:30

返回 AI技术