从零搭建自定义 MCP 服务器：让 AI Agent 接入你的私有数据

MCP（Model Context Protocol）是 2026 年 AI Agent 接入外部数据的事实标准。本教程手把手教你用 Node.js/TypeScript 搭建一个自定义 MCP 服务器，让 Claude/Cursor 等 AI 编程工具直接读取你的私有数据库和 API 数据。

20 分钟 5 个步骤2026-09-28

1理解 MCP 协议工作原理

在开始编码之前，先搞清楚 MCP 的核心概念： **MCP 是什么？** MCP（Model Context Protocol）是 Anthropic 于 2025 年推出的开放协议，定义了 AI 模型与外部工具/数据源之间的通信标准。简单说，它让 AI Agent 能像调用本地函数一样调用远程服务。 **核心架构：** MCP 服务器（Server） ←→ MCP 客户端（Client/Host） ←→ AI 模型 - **MCP 服务器**：你写的代码，暴露工具（Tools）和资源（Resources）给 AI - **MCP 客户端**：Claude Code、Cursor 等 AI 编程工具，管理连接 - **传输层**：标准输入输出（stdio）用于本地进程通信，HTTP+SSE 用于远程服务器 **MCP 的两大核心概念：** 1. **Tools（工具）**：AI 可调用的函数。类似 Function Calling，但标准化了 Schema 定义 2. **Resources（资源）**：AI 可读取的数据源。类似文件系统，有 URI 和 MIME 类型 💡 MCP 最值得关注的特点是「一次开发，到处运行」——你写的 MCP 服务器可以同时被 Claude Code、Cursor、VS Code 的 Continue 插件等多个工具使用。

小贴士

🎯 从简单的「读取型」工具开始（查询数据库、搜索文档），再逐步增加「写入型」工具（创建工单、发送邮件）——先建立信任再开放写权限
🛡️ 工具定义中的 description 字段非常重要——AI 根据描述决定是否调用工具。描述越清晰准确，AI 的调用成功率越高。不要写「处理数据」这种模糊描述
📦 MCP 服务器支持热更新：修改代码 → 重新编译 → 在 AI 工具中重新连接即可，不需要重启编辑器。Claude Code 中执行 claude mcp restart 即可
🔗 一个 MCP 服务器可以暴露多个工具，推荐按领域分组（如 db-tools、api-tools、search-tools），而不是把所有工具塞到一个服务器里

1 / 5