MCP协议开发实战,从零搭建AI Agent工具链,7月28日MCP正式规范发布,手把手教你用无状态架构搭建属于自己的AI Agent服务器
目录一、 什么是 MCP为什么它是 AI Agent 的“标准插座”二、 从零搭建一个简单的“天气/运维”MCP Server1. 环境准备2. 编写核心代码 (server.py)三、 无状态架构为什么是“无状态”四、 如何让 AI 调用它五、 给开发者的进阶技巧实战避坑六、 总结通往 AI Agent 运维化之路如果您喜欢此文章请收藏、点赞、评论谢谢祝您快乐每一天。随着Model Context Protocol (MCP)在 7 月底的正式发布AI Agent 的开发范式发生了剧变。过去开发者需要为每一个 AI 模型Claude, ChatGPT 等重复对接各种工具而现在MCP 提供了一个标准的“通用接口”让 AI 服务器像连接打印机一样连接各种工具、数据库和 API。一、 什么是 MCP为什么它是 AI Agent 的“标准插座”MCP 的核心在于将AI 模型Host与外部资源/工具Server分离Host (客户端):例如 Claude Desktop, Cursor, 或你自己写的 Agent。Server (服务端):实现 MCP 协议的程序提供工具Tools、资源Resources和提示词Prompts。核心优势一次开发随处调用。你用 Node.js 或 Python 写一个 MCP ServerClaude Desktop 能用Cursor 能用未来所有支持 MCP 的 AI 都能直接调用。二、 从零搭建一个简单的“天气/运维”MCP Server我们以Python SDK为例搭建一个能够查询内网服务状态或简单信息的 MCP Server。1. 环境准备# 创建项目目录mkdir my-mcp-server cd my-mcp-serverpython -m venv venv source venv/bin/activatepip install mcp2. 编写核心代码 (server.py)MCP Server 的本质是一个基于JSON-RPC的无状态通信程序。from mcp.server.fastmcp import FastMCP# 初始化 Server名字叫 Ops-Toolsmcp FastMCP(Ops-Tools)# 定义一个工具AI 可以直接调用这个函数mcp.tool()def get_service_status(service_name: str) - str:查询指定服务的运行状态# 模拟内网运维逻辑if service_name db-prod:return Service db-prod is running normally (latency: 12ms).return fService {service_name} not found.if __name__ __main__:mcp.run()三、 无状态架构为什么是“无状态”MCP 协议被设计为无状态 (Stateless)是极其明智的弹性扩展由于 Server 不保存对话上下文你可以通过 Nginx 或负载均衡器轻松横向扩展多个实例。安全隔离每个请求都是独立的不会出现跨用户污染。便于调试你可以通过标准输入/输出 (stdio) 直接运行脚本进行调试而不需要搭建复杂的长连接。四、 如何让 AI 调用它你需要告诉 AI以 Claude Desktop 为例你的 Server 在哪里。在配置文件~/Library/Application Support/Claude/claude_desktop_config.json中添加{mcpServers: {my-ops-tool: {command: python,args: [/path/to/my-mcp-server/server.py]}}}重启 Claude Desktop 后你会看到一个“小插头”图标点击它AI 就已经“学会”了如何通过get_service_status函数与你的系统交互。重启 Claude Desktop 后你会看到一个“小插头”图标点击它AI 就已经“学会”了如何通过get_service_status函数与你的系统交互。五、 给开发者的进阶技巧实战避坑数据流监控MCP Server 默认通过stdio通信。如果你想调试可以在启动脚本中将stderr重定向到一个日志文件或者在代码中加入logging.basicConfig(filenamemcp.log, levellogging.DEBUG)。安全性重中之重不要暴露敏感权限MCP Server 运行在本地如果你的工具允许执行rm -rfAI 可能会误操作。最小化原则工具函数中一定要加入权限检查比如只读数据库连接或者通过鉴权层拦截请求。利用资源Resources而非工具ToolsTools是“动作”如发送邮件、查询数据库。Resources是“数据”如读取服务器配置文档、查看日志片段。如果你只是给 AI 提供信息请使用Resources它能让模型更高效地获取上下文。六、 总结通往 AI Agent 运维化之路MCP 的发布标志着AI Agent 从“玩具”向“基础设施”的转变。对于运维你不再需要开发繁琐的 API 接口只需要把现有的运维脚本套上一层 MCP 外壳AI 就能自主诊断故障。对于开发者你正在构建的是一个标准化的生态。今天你为自己的公司写了一个 MCP 数据库查询工具明天你就可以把同样的逻辑迁移到 Cursor 中作为你个人的代码分析助手。建议下一步尝试将你的企业内网 API 或常用的 CLI 工具封装进一个 MCP Server。当你第一次在聊天框输入“查询下 db-prod 的状态”并看到 AI 自主执行该函数时你会感受到 AI 运维的真正魅力。如果您喜欢此文章请收藏、点赞、评论谢谢祝您快乐每一天。

相关新闻

7、Rust程序设计语言——常见集合

7、Rust程序设计语言——常见集合

目录1. Vector1.1 新建vector1.2 更新vector1.3 读取vector的元素1.4 遍历vector中的元素1.5 使用枚举储存多种类型1.6 丢弃vector时也会丢弃其所有元素2. String2.1 定义字符串2.2 新建字符串2.3 更新字符串2.3.1 使用push_str和push追加字符串2.3.2 使用运算符或format!宏拼接…

2026/9/25 5:46:39 阅读更多 →
HTTP与HTTPS核心区别及安全握手过程详解

HTTP与HTTPS核心区别及安全握手过程详解

1. HTTP与HTTPS的本质区别HTTP(HyperText Transfer Protocol)和HTTPS(HyperText Transfer Protocol Secure)是互联网上应用最广泛的两种传输协议。它们最核心的区别在于数据传输的安全性。HTTP协议诞生于1991年,采用明…

2026/9/24 10:09:06 阅读更多 →
C++智能指针详解:RAII原理、unique_ptr与shared_ptr实战指南

C++智能指针详解:RAII原理、unique_ptr与shared_ptr实战指南

1. 项目概述:为什么我们需要智能指针?在C的世界里,内存管理一直是个让人又爱又恨的话题。爱的是,手动管理内存给了我们极致的控制权,能写出性能极高的代码;恨的是,一个不小心,内存泄…

2026/9/23 21:06:47 阅读更多 →

最新新闻

使用 VoltAgent 构建 YouTube 转博客 Agent:MCP 工具、共享记忆与 Supervisor 编排实战

使用 VoltAgent 构建 YouTube 转博客 Agent:MCP 工具、共享记忆与 Supervisor 编排实战

人工智能AI AgentAgent 框架后端多智能体RAG工具调用Agent 记忆 【免费下载链接】voltagent AI Agent Engineering Platform built on an Open Source TypeScript AI Agent Framework 项目地址: https://gitcode.com/gh_mirrors/vo/voltagent 点击查看 免费下载 本…

2026/9/25 5:46:34 阅读更多 →
用Winhance外部应用功能快速装机:WinGet一键安装常用软件指南

用Winhance外部应用功能快速装机:WinGet一键安装常用软件指南

用Winhance外部应用功能快速装机:WinGet一键安装常用软件指南 【免费下载链接】Winhance-zh_CN A Chinese version of Winhance. C# application designed to optimize and customize your Windows experience. 项目地址: https://gitcode.com/gh_mirrors/wi/Winh…

2026/9/25 5:46:34 阅读更多 →
Read the Docs 文档内搜索 UI 设计:Search-as-you-type 的设计思路、后端选型与落地现状

Read the Docs 文档内搜索 UI 设计:Search-as-you-type 的设计思路、后端选型与落地现状

后端文档 【免费下载链接】readthedocs.org The source code that powers readthedocs.org 项目地址: https://gitcode.com/gh_mirrors/re/readthedocs.org 点击查看 免费下载 本文基于 Read the Docs 的设计文档 In-doc search UI 展开,完整解读“边输…

2026/9/25 5:46:34 阅读更多 →
ZYNQ上FreeRTOS实战:Vitis 2023.2从工程创建到调试全流程

ZYNQ上FreeRTOS实战:Vitis 2023.2从工程创建到调试全流程

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/9/25 5:46:34 阅读更多 →
Easy-Vibe 安全思维与攻防基础:XSS、SQL 注入、CSRF 的原理剖析与上线前安全自查清单

Easy-Vibe 安全思维与攻防基础:XSS、SQL 注入、CSRF 的原理剖析与上线前安全自查清单

教程文档 【免费下载链接】easy-vibe 从 0 到 1 学会 vibe coding,项目制学习 项目地址: https://gitcode.com/datawhalechina/easy-vibe 点击查看 免费下载 安全不是"安全团队的事",而是每个开发者的基本功。本文基于 Easy-Vibe …

2026/9/25 5:46:34 阅读更多 →
如何用MindSpeed LLM YaRN扩展上下文:长文本训练技巧详解

如何用MindSpeed LLM YaRN扩展上下文:长文本训练技巧详解

如何用MindSpeed LLM YaRN扩展上下文:长文本训练技巧详解 【免费下载链接】MindSpeed-LLM 昇腾LLM分布式训练框架 项目地址: https://gitcode.com/Ascend/MindSpeed-LLM MindSpeed-LLM 是昇腾 LLM 分布式训练框架,内置 YaRN 上下文扩展能力&#…

2026/9/25 5:45:34 阅读更多 →

日新闻

AI元人文:从工具使用到思维重构的深度探索

AI元人文:从工具使用到思维重构的深度探索

最近半年我一直在琢磨一件事:AI元人文到底是什么?说白了,就是“用元视角重新审视人与AI的关系”,也在“探索AI如何反向逼着我们发现自己的思考边界”。标题里的“元探索”,在我看就是一层套一层的追问——当你用AI解决…

2026/9/25 0:00:41 阅读更多 →
Python+CNN车牌识别实战:从数据预处理到模型训练与部署

Python+CNN车牌识别实战:从数据预处理到模型训练与部署

简介:基于Python与卷积神经网络的车牌识别项目,面向计算机视觉初学者及智能交通开发者,目标是帮助用户掌握从数据预处理、模型构建到实际部署的完整流程。压缩包共25个文件,包含jpg/png图像样本、py训练脚本、md说明文档、dat数据…

2026/9/25 0:00:41 阅读更多 →
Vim基础操作全攻略:保存退出、模式切换与高频命令实战

Vim基础操作全攻略:保存退出、模式切换与高频命令实战

1. 项目概述1.1 核心需求解析今天聊聊Vim。写这个题目的原因是:几乎每个后端开发者、运维人员、数据工程师某天都会遇到一个场景——深夜加班,服务器登录界面只有黑底白字,编辑器只有vi/vim,你必须在五分钟内完成一次配置修改并保…

2026/9/25 0:00:41 阅读更多 →

周新闻

Flutter for OpenHarmony游戏卡片渐变背景实战:从原理到性能优化

Flutter for OpenHarmony游戏卡片渐变背景实战:从原理到性能优化

直接铺开项目本身吧。这几个月我一直在折腾一件事:用Flutter给OpenHarmony做一款游戏集合类的App,说白了就是把若干小游戏塞进一个壳里,用统一入口分发。这个方向本身不算新鲜,真正让我花了不少心思的,是首页那堆游戏卡…

2026/9/24 14:34:13 阅读更多 →
Word表格编号全攻略:从列表编号到题注交叉引用

Word表格编号全攻略:从列表编号到题注交叉引用

写Word文档,最让人头疼的往往是那些“看起来不起眼”的小问题。比如表格编号这事:今天在表后面多加了两个空白行,明天给客户交稿前发现整个章节的编号全部错位,光是挨个改序号就能耗掉大半个下午。我前阵子帮人整理一份上百页的技…

2026/9/24 9:10:42 阅读更多 →
从第一个站到第二个站:独立开发者的静态网站选型与落地实践

从第一个站到第二个站:独立开发者的静态网站选型与落地实践

1. 项目概述1.1 核心需求解析做独立开发者这几年,说实话,第一个网站上线的那天晚上我兴奋得没睡着。但等它跑了半年,流量惨淡、功能臃肿、代码自己都懒得看第二遍之后,我才慢慢琢磨明白一个道理:第一个网站是练手&…

2026/9/24 14:33:56 阅读更多 →

月新闻

持续集成 流水线自动化与 声明式交付 实践:原型怎样变成可用功能

持续集成 流水线自动化与 声明式交付 实践:原型怎样变成可用功能

持续集成 流水线自动化与 声明式交付 实践:原型怎样变成可用功能分类:[AI/大模型]细分主题:AI 增强型 CI/CD 流水线自动化与 GitOps 实践:Agent 工作流、工具调用与任务拆解:从原型到生产的验收清单很多团队在尝试用大…

2026/9/24 12:50:34 阅读更多 →
容器编排 生产环境运维与排障实战:复盘记录怎样真正派上用场

容器编排 生产环境运维与排障实战:复盘记录怎样真正派上用场

容器编排 生产环境运维与排障实战:复盘记录怎样真正派上用场分类:[工程技术]细分主题:Kubernetes 生产环境运维与排障实战:可复制的项目复盘模板与决策记录大部分团队的事故复盘报告,最后都变成了躺在 Confluence 或钉…

2026/9/24 14:33:48 阅读更多 →
容器 容器化技术与镜像安全管理:核心链路应该先拆哪一步

容器 容器化技术与镜像安全管理:核心链路应该先拆哪一步

容器 容器化技术与镜像安全管理:核心链路应该先拆哪一步分类:[工程技术]细分主题:Docker 容器化技术与镜像安全管理:核心链路的逐步实现与关键代码取舍面对一个积累了五六年历史包袱的单体架构应用(包含 Web 接口、后台…

2026/9/24 12:49:17 阅读更多 →