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

简介: 本文手把手教你用Node.js从零搭建私人MCP(模型上下文协议)服务器,解决AI无法直接访问本地文件、数据库等痛点。含环境配置、TypeScript编译避坑、Hello World工具开发及Inspector调试全流程,助你赋予AI真实行动力!

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

没有错误的话就是下面图片展示的结果

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

然后使用上面的命令重新编译即可。

运行文件,这里注意路径和文件名!运行后会卡在这里!

node build/index.js

4、见证奇迹

重新开一个终端窗口,这里使用下面命令运行 Inspector(这是MCP官方提供的交互式调试和测试工具),连接到刚刚启动的 MCP 服务器,然后会启动服务,以及给一个session token

npx @modelcontextprotocol/inspector node build/index.js

打开浏览器运行 localhost:6274,打开MCP Inspector,选择设置,在最后输入session token,然后点击连接就可以看到成功了。

打开右侧的Tools,选择List Tools ,找到刚刚写的mcp,直接运行在下面就可以看到结果啦。

进阶玩法

下图是MCP代码的流程图,可以参考学习一下

这里我又用Ai写了一个简单的MCP工具,可以实现运行工具打开百度搜索指定的信息。

下图是测试结果:

5、总结

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

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

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

相关文章
|
6天前
|
人工智能 安全 API
CoPaw:5分钟部署你的 AI助理
源自阿里巴巴开源生态的个人 AI 助理——CoPaw。作为阿里倾力打造的开源力作,CoPaw 完美打通钉钉、飞书、Discord 等多平台对话通道,支持定时任务自动化。内置 PDF/Office 深度处理、新闻摘要等强大技能,更开放自定义扩展接口。坚持数据全程私有化部署,绝不上传云端,让每一位用户都能在大厂技术加持下,拥有安全、专属的智能助手。
|
9天前
|
人工智能 自然语言处理 JavaScript
2026年Windows+Ollama本地部署OpenClaw保姆级教程:本地AI Agent+阿里云上快速搭建
2026年OpenClaw凭借本地部署、私有化运行的特性,成为打造个人智能体的核心工具,而Ollama作为轻量级本地大模型管理工具,能让OpenClaw摆脱对云端大模型的依赖,实现**本地推理、数据不泄露、全流程私有化**的智能体验。本文基于Windows 11系统,从硬件环境准备、Ollama安装与模型定制、OpenClaw部署配置、技能扩展到常见问题排查,打造保姆级本地部署教程,同时补充阿里云OpenClaw(Clawdbot)快速部署步骤,兼顾本地私有化需求与云端7×24小时运行需求,文中所有代码命令均可直接复制执行,确保零基础用户也能快速搭建属于自己的本地智能体。
10362 80
|
7天前
|
人工智能 安全 JavaScript
阿里云上+本地部署OpenClaw(小龙虾)新手攻略:解锁10大必备Skills,零基础也能玩转AI助手
2026年,开源AI代理工具OpenClaw(昵称“小龙虾”)凭借“能实际做事”的核心优势,在GitHub斩获25万+星标,成为现象级AI工具。它最强大的魅力在于可扩展的Skills(技能包)系统——通过ClawHub插件市场的数百个技能,能让AI助手从简单聊天升级为处理办公、学习、日常事务的全能帮手。
6008 16
|
8天前
|
人工智能 自然语言处理 机器人
保姆级教程:Mac本地搭建OpenClaw及阿里云上1分钟部署OpenClaw+飞书集成实战指南
OpenClaw(曾用名Clawdbot、Moltbot)作为2026年最热门的开源个人AI助手平台,以“自然语言驱动自动化”为核心,支持对接飞书、Telegram等主流通讯工具,可替代人工完成文件操作、日历管理、邮件处理等重复性工作。其模块化架构适配多系统环境,既可以在Mac上本地化部署打造私人助手,也能通过阿里云实现7×24小时稳定运行,完美兼顾隐私性与便捷性。
5916 13
|
10天前
|
人工智能 JSON JavaScript
手把手教你用 OpenClaw + 飞书,打造专属 AI 机器人
手把手教你用 OpenClaw(v2026.2.22-2)+ 飞书,10分钟零代码搭建专属AI机器人!内置飞书插件,无需额外安装;支持Claude等主流模型,命令行一键配置。告别复杂开发,像聊同事一样自然对话。
6115 15
手把手教你用 OpenClaw + 飞书,打造专属 AI 机器人
|
5天前
|
人工智能 JavaScript Ubuntu
5分钟上手龙虾AI!OpenClaw部署(阿里云+本地)+ 免费多模型配置保姆级教程(MiniMax、Claude、阿里云百炼)
OpenClaw(昵称“龙虾AI”)作为2026年热门的开源个人AI助手,由PSPDFKit创始人Peter Steinberger开发,核心优势在于“真正执行任务”——不仅能聊天互动,还能自动处理邮件、管理日程、订机票、写代码等,且所有数据本地处理,隐私完全可控。它支持接入MiniMax、Claude、GPT等多类大模型,兼容微信、Telegram、飞书等主流聊天工具,搭配100+可扩展技能,成为兼顾实用性与隐私性的AI工具首选。
3540 7
|
2天前
|
人工智能 JavaScript 测试技术
保姆级教程:OpenClaw阿里云及本地部署+Claude Code集成,打造全能 AI 编程助手
在AI编程工具百花齐放的2026年,Anthropic推出的Claude Code凭借72.5%的SWE-bench测试高分、25倍于GitHub Copilot的上下文窗口,成为开发者追捧的智能编程助手。但单一工具仍有局限——Claude Code擅长代码生成与审查,却缺乏灵活的部署与自动化执行能力;而OpenClaw(前身为Clawdbot)作为开源AI代理框架,能完美弥补这一短板,通过云端与本地双部署,实现“代码开发-测试-部署”全流程自动化。
1747 13
|
5天前
|
人工智能 JavaScript API
阿里云及本地 Windows 部署(OpenClaw+Ollama)保姆级教程及技能扩展与问题排查
OpenClaw(原Clawdbot)作为2026年主流的开源AI智能体工具,具备系统级操作权限,能将自然语言指令转化为文件操作、程序控制等实际行为。搭配轻量级本地大模型管理工具Ollama,可实现本地推理、数据私有化存储的全闭环;而阿里云提供的云端部署方案,则能满足7×24小时稳定运行需求。本文将详细拆解2026年阿里云与本地(Windows 11系统)部署OpenClaw的完整流程,包含Ollama模型定制、技能扩展及常见问题排查,所有代码命令可直接复制执行,零基础用户也能快速上手。
2147 3

热门文章

最新文章