# 1、 为什么我们需要 MCP？

你是否也有过这样的抓狂时刻：想让 AI 帮你看一下本地的日志文件，或者读取一下数据库里的最新数据，却只能手动复制粘贴，不仅繁琐，而且一旦数据更新，又得重来一遍。

MCP（模型上下文协议）它提供了一种标准化的客户端-服务端架构。只要你的 AI 助手支持 MCP，就能通过这个协议，丝滑地读取本地文件、访问私有数据库或调用外部 API。

今天，我们就来剥开 MCP 的神秘外衣，从零开始，用 Node.js 搭建一个属于你自己的私人 MCP 服务器。别担心，这比你想象的要简单得多。
# 2、环境准备

打开终端，用下面命令检查是否安装了node js和npm
```
node -v   #检查nodejs安装
npm -v  #检查npm安装
```
创建一个mcpServer文件夹，然后在文件夹里使用npm进行初始化设置，以及安装MCP的官方SDK
```
npm init -y
npm install @modelcontextprotocol/sdk
```
没有错误的话就是下面图片展示的结果
![](https://developer.qcloudimg.com/http-save/yehe-12068838/32cca511274c643a2767c0907e44cc95.png)

# 3、核心实战与防坑指南

使用任意代码编辑器，打开mcpServer文件，创建src文件夹，新建文件index.ts文件，开始编写代码
```
// 1. 导入依赖
import { McpServer } from"@modelcontextprotocol/sdk/server/mcp.js";
import { StdioServerTransport } from"@modelcontextprotocol/sdk/server/stdio.js";

// 2. 创建服务器实例
export const server =new McpServer({
        name: "my-mcp-server", // 给你的服务器起个名字
        version: "0.0.1", // 版本号
});

// 3. 定义一个工具（Tool）：起名叫 "say_hello"
server.tool(
        "say_hello", // 工具的名称
        { }, // 输入参数，这里为空
        async ()=> {
                return {
                        content: [{ type: "text", text: "Hello, World! From my first MCP server!" }],
                };
        }
);

// 4. 启动服务器
async function main(): Promise<void> {
        const transport = new StdioServerTransport();
        await server.connect(transport);
}

// 5. 执行启动
main().catch((error: Error) => {
        console.error("Server startup failed:", error);
        process.exit(1);
});

```
这里编写的第一个初始mcp，是实现调用说Hello World的工具。

使用下面命令进行编译：
```
npx tsc index.ts --outDir build --target ES2020 --module commonjs --esModuleInterop
```
在编译阶段，你可能会和我一样踩中两个坑：
第一个报错是没有安装TypeScript编译器，可以使用下面命令安装编译器
```
npm install typescript
```
第二个报错是缺少 Node.js 的类型定义，可以使用下面命令安装类型定义
```
npm install --save-dev @types/node
```
![](https://developer.qcloudimg.com/http-save/yehe-12068838/784167820e7c1e31f756510a082d1a17.png)

然后使用上面的命令重新编译即可。
![](https://developer.qcloudimg.com/http-save/yehe-12068838/4378c94e95874a0a5431082d7f90af07.png)
运行文件，这里注意路径和文件名！运行后会卡在这里！
```
node build/index.js
```
# 4、见证奇迹
重新开一个终端窗口，这里使用下面命令运行 Inspector（这是MCP官方提供的交互式调试和测试工具），连接到刚刚启动的 MCP 服务器，然后会启动服务，以及给一个session token
```
npx @modelcontextprotocol/inspector node build/index.js
```
![](https://developer.qcloudimg.com/http-save/yehe-12068838/e95ae81dedcf3d27167e0df8f484b19c.png)

打开浏览器运行 localhost:6274，打开MCP Inspector，选择设置，在最后输入session token，然后点击连接就可以看到成功了。
![](https://developer.qcloudimg.com/http-save/yehe-12068838/f8e0fb555affee6f8e9a02ff87417d32.png)
打开右侧的Tools，选择List Tools ，找到刚刚写的mcp，直接运行在下面就可以看到结果啦。
![](https://developer.qcloudimg.com/http-save/yehe-12068838/cf71a4147d944ee0328aecc8dc9418fa.png)

# 进阶玩法
下图是MCP代码的流程图，可以参考学习一下
![](https://developer.qcloudimg.com/http-save/yehe-12068838/b74e66a551ce2caf288e0b658e13e2ce.png)

这里我又用Ai写了一个简单的MCP工具，可以实现运行工具打开百度搜索指定的信息。
![](https://developer.qcloudimg.com/http-save/yehe-12068838/2d83de2c088a5dbf767121e7367860b4.png)

下图是测试结果：
![](https://developer.qcloudimg.com/http-save/yehe-12068838/b61bdb8cbcb8b12fcf011437547705ca.png)

# 5、总结

到这里搭建 MCP 服务器就完成了，MCP的本质其实就是**赋予 AI 行动能力**。顺着这个思路，你可以把自己的笔记、本地的 MySQL 数据库、甚至是家里的智能家居 API，全部打包成 MCP 工具，喂给你的 AI 助手。到那时，AI 就不再只是一个聊天窗口，而是真正懂你、能帮你处理私人事务的超级助理。

**你打算用 MCP 把什么工具接入给你的 AI 呢？** 欢迎在评论区留下你的脑洞，如果遇到报错或者配置问题，也随时在评论区找我交流。

如果这篇文章帮你避开了配置过程中的坑，别忘了点赞在看或收藏。

你是否也有过这样的抓狂时刻：想让 AI 帮你看一下本地的日志文件，或者读取一下数据库里的最新数据，却只能手动复制粘贴，不仅繁琐，而且一旦数据更新，又得重来一遍。

AI工具的“超级外挂”：从零手把手教你搭建私人 MCP 服务器

从零手把手教你搭建私人 MCP 服务器

人工智能

后端

开发工具

MCP协议让AI轻松访问本地文件、数据库和API，摆脱手动复制粘贴的繁琐。本文手把手教你用Node.js搭建私人MCP服务器，从环境配置到核心代码实现，包含常见报错解决方案。通过MCP可将笔记、数据库、智能家居等接入AI，打造真正懂你的智能助手。

日志文件

SQL数据库

TypeScript

数据库

服务器

编译器

MySQL

腾讯云数据库特惠，新用户首单0.5折起


文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

AI工具的“超级外挂”：从零手把手教你搭建私人 MCP 服务器-腾讯云开发者社区-腾讯云

AI工具的“超级外挂”：从零手把手教你搭建私人 MCP 服务器

AI工具的“超级外挂”：从零手把手教你搭建私人 MCP 服务器

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐