手写第一个 MCP Server:从搭环境到让 Harness 调用本地文件
上篇我说了花了一个月研究 MCP发现它跟 Harness 是天然搭档。但说实话光看协议文档是看不出来什么东西的——你得真的动手写一个。我写第一个 MCP Server 的契机其实挺土的。有次我跑了一个 Agent 任务结果文件到处乱丢——有在/tmp的有在工作目录的还有跑到~/.cache下面的。我当时就想能不能让 Agent 读写文件的时候统一走一个文件管家别自己乱写然后我就开始搭 MCP Server 了。先说环境准备。MCP 官方推荐用 Python 或 TypeScript 写 Server我选了 Python——不是因为它多好是因为我手头一堆 Python 脚本懒得翻译。你需要的其实就三个东西Python 3.10、pip install mcp、以及一个文本编辑器。笑死我第一次跑pip install mcp的时候还以为会装一堆依赖结果就一个包——mcp本身不到 200KB。这个包封装了 MCP 协议的全部通信逻辑包括 JSON-RPC 的消息格式、请求/响应的生命周期管理、以及stdio和SSE两种传输模式。你不需要自己写 JSON 解析也不需要处理 WebSocket 连接暴露一个函数就是加一个 Tool。来看最小实现。我写了一个能读文件和写文件的 MCP Server核心代码加注释不到 60 行from mcp.server import Server, NotificationOptions from mcp.server.models import InitializationOptions import mcp.server.stdio # 创建一个 Server 实例 server Server(file-manager) # 注册一个 Tool读文件 server.list_tools() async def handle_list_tools() - list: return [ { name: read_file, description: 读取指定路径的文件内容, inputSchema: { type: object, properties: { path: {type: string, description: 文件路径} }, required: [path] } }, { name: write_file, description: 写入内容到指定路径的文件, inputSchema: { type: object, properties: { path: {type: string, description: 文件路径}, content: {type: string, description: 文件内容} }, required: [path, content] } } ] server.call_tool() async def handle_call_tool(name: str, arguments: dict) - list: if name read_file: with open(arguments[path], r) as f: content f.read() return [{type: text, text: content}] elif name write_file: with open(arguments[path], w) as f: f.write(arguments[content]) return [{type: text, text: 写入成功}] async def main(): async with mcp.server.stdio.stdio_server() as (read_stream, write_stream): await server.run(read_stream, write_stream, InitializationOptions( server_namefile-manager, server_version0.1.0 ))跑起来就一行python file_manager.py。然后这个 Server 就开始监听stdio等着 MCP Client 来调它。你可能会问这跟写一个普通的 Python 脚本有什么区别区别在于它暴露的是标准化的接口。任何支持 MCP 协议的客户端——Claude Desktop、VS Code 的 Copilot、当然也包括 Harness——都能直接调这两个函数不需要知道底层是怎么实现的。但这里有个坑。我第一次跑通之后兴冲冲地让 Harness 去调这个 Server结果发现——MCP 协议默认走的是stdio也就是子进程的标准输入输出流。这意味着 MCP Server 和 Client 必须在同一个进程树里。Harness 跑 Agent 的时候Agent 本身是一个子进程如果 Agent 再启一个 MCP Server 子进程进程管理就变得很复杂。你关 Agent 的时候MCP Server 可能没关掉变成孤儿进程挂在系统里。我查了一下MCP 协议支持两种传输模式除了stdio还有SSEServer-Sent Events服务端推送事件。SSE模式把 MCP Server 跑成一个 HTTP 服务客户端通过 HTTP 请求来调用工具。这样 Client 和 Server 就解耦了各自独立管理生命周期。我改了一下把stdio换成SSEfrom mcp.server.sse import SseServerTransport from starlette.applications import Starlette from starlette.routing import Route sse SseServerTransport(/messages) async def handle_sse(request): async with sse.connect_sse(request.scope, request.receive, request._send) as streams: await server.run(streams[0], streams[1], InitializationOptions( server_namefile-manager, server_version0.1.0 )) app Starlette(routes[ Route(/sse, endpointhandle_sse), Route(/messages, endpointsse.handle_post_message), ])跑起来变成uvicorn file_manager:app --port 8000。现在 Harness 那边配置一个 HTTP 工具的地址为http://localhost:8000/sse就能调这个 MCP Server 了。你别说我在 Harness 里配好之后对着 Agent 说了一句帮我把/tmp/result.txt的内容读出来然后加一行 done 再写回去——Agent 真的自己调了read_file再调write_file整个过程不到 3 秒。我盯着终端看了半天感觉这玩意儿比我想象的实用得多。当然这个版本还有很多问题。比如没有路径安全校验Agent 说read_file /etc/passwd它真的会读。也没有并发控制同时来两个请求可能会写冲突。更没有错误重试网络闪断一次就挂了。但话说回来60 行代码就能让 Harness 拥有一个文件管理工具而且这个工具不仅 Harness 能用其他任何 MCP 客户端也能用——这个性价比我觉得挺值的。下一篇咱们搞个数据库 MCP Server让 Agent 自己查数据库、写报表。你平时写 Agent 的时候最想让它能自动调什么工具评论区说说我考虑优先安排上。

相关新闻

基于YOLO的金鱼疾病智能检测:从数据集构建到模型部署全流程

基于YOLO的金鱼疾病智能检测:从数据集构建到模型部署全流程

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

2026/11/22 17:24:40 阅读更多 →
混凝土缺陷检测数据集:VOC+YOLO双格式7513张7类工业级资源

混凝土缺陷检测数据集:VOC+YOLO双格式7513张7类工业级资源

简介:本资源是面向计算机视觉方向研究者与工程实践者的混凝土结构缺陷检测专用数据集,适用于目标检测模型训练、算法对比与工业质检场景落地。数据集涵盖7类典型病害:可见裂斑、分层、风化、缝隙、剥落、脱落、锈迹,共7513张高质量…

2026/11/22 17:24:40 阅读更多 →
Python全栈数据平台实战:从爬虫到深度学习的完整项目构建

Python全栈数据平台实战:从爬虫到深度学习的完整项目构建

简介:这是一套面向高校教学与Python全栈开发初学者的实战型数据工程平台,聚焦数据采集、存储、分析与AI应用全流程,解决从网页抓取到模型部署的链路断点问题。资源包共2002个文件,含1323份Markdown技术文档(覆盖爬虫原…

2026/11/20 16:08:03 阅读更多 →

最新新闻

Electron桌面应用开发实战:从环境搭建到打包发布全流程

Electron桌面应用开发实战:从环境搭建到打包发布全流程

做前端这些年,我大部分时间都在跟浏览器标签页打交道,直到第一次把桌面应用跑起来,才发现原来自己一直被限制在地址栏和刷新按钮围起来的框框里。Electron这个词,最开始是在某段时间频繁出现在同事的讨论里,一个用HTML…

2026/11/21 23:27:35 阅读更多 →
滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

滑盖智能锁T109深度解析:结构原理、安装调试与故障排查

简介:亚太天能T109滑盖智能锁产品说明书是一份PDF格式的官方技术文档,主要面向智能锁安装人员、终端用户及售后维护者,帮助快速掌握产品安装、配置与常见故障处理。全包仅1个PDF文件,大小4.37MB,内容结构清晰&#xff…

2026/11/21 23:27:35 阅读更多 →
PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

PMSM弱磁控制原理与Simulink建模:高速AGV驱动系统设计指南

上个月我在调试一台高速AGV的驱动系统,整车要求空载跑到8m/s,电机转速已经拉到额定点,驱动器的输出电压也顶到了母线电压极限附近。再往上踩速度指令,转速纹丝不动,三相电流反而开始震荡。那会儿我的第一反应就是&…

2026/11/21 23:27:35 阅读更多 →
C++核心知识点:从内存管理到STL的实战指南

C++核心知识点:从内存管理到STL的实战指南

C 这门语言我前前后后折腾了十几年,用它写过嵌入式驱动、做过游戏服务端,也搭过基础组件库。每次看到新人一头扎进"C 核心知识点"这个搜索词,我其实挺感慨的——这门语言的难点从来不是语法多,而是知识点之间的耦合太深…

2026/11/21 23:27:35 阅读更多 →
T109滑盖智能锁怎么装?安装调试与故障排查全攻略

T109滑盖智能锁怎么装?安装调试与故障排查全攻略

简介:亚太天能T109滑盖智能锁产品说明书以PDF格式发布,适合智能锁用户、安装人员与售后维修人员阅读。内容围绕T109系列指纹密码刷卡锁展开,先介绍前面板、后面板、锁体、机械钥匙、电池盒盖等部件名称与功能,再给出完整安装步骤&…

2026/11/21 23:27:36 阅读更多 →
LLM知识降熵:从信息垄断到理解权下放

LLM知识降熵:从信息垄断到理解权下放

你有没有过这种经历:翻开源码注释、论文摘要或者一份专业报告,每个字都认识,连在一起却像天书。想找人聊聊,身边要么没人懂,要么懂的懒得跟你解释。后来我试着把同一段内容丢给一个大语言模型,几秒钟之后&a…

2026/11/21 23:27:37 阅读更多 →

日新闻

周新闻

月新闻