手把手教你如何写一个自己的mcp 服务

摘要： MCP（Model Context Protocol）作为大模型与外部资源的标准化接口协议，解决了AI模型调用本地文件、工具或API的兼容性问题。本文基于Python技术栈，详细拆解MCP服务的开发全流程：从环境配置（Python≥3.10、虚拟环境、SDK安装）到核心开发（工具函数、资源、提示词模板的定义），再到客户端调用与调试（CLINE配置、MCP Inspector排查）。通过具体代码示例（如获取桌面文件列表、生成问候语等），演示如何实现“5分钟快速开发”，并给出高级应用建议（权限控制、AP

全程是模型上下文协议， mcp server作为ai与外部工具的中间层， 代替人类访问或操作外部工具。MCP本质上就是一段python程序，大模型通过操作系统的STDIO(标准输入输出通道或SSE协议调用某个MCP Server， 通过指定的消息格式。MCP Server接收到这些消息后，通过代码或调用api来访问外部工具并且完成任务。mcp简单来说就是ai大模型的标准化工具箱，mcp server对接到aip客户端里实现各种智能体与工作流。uv是Python包管理领域的一个强大而有前途的新工具。

自己动手写一个联网 MCP 工具是掌握 MCP 协议最有效的方式。下面将手把手教你，用 Python 和fastmcp库，从零开始创建一个的 MCP 服务器。我们将使用免费的库作为搜索引擎后端，它不需要 API 密钥，非常适合入门。

「MCP技术实战」来啦‼️带你从0到1快速掌握这项爆火🔥Agent技术！

MCP（Model Context Protocol，模型上下文协议）是由Anthropic公司提出的一种开放标准协议，旨在标准化大语言模型（LLM）与外部工具、数据源之间的交互方式。它通过客户端-服务器架构，让AI模型能够安全、动态地访问本地或远程资源（如文件系统、数据库、API等），打破传统AI的数据孤岛限制。

对你的“自学AI成长之路”来说，创建MCP服务器是一个极佳的实践项目。从路径一 (FastMCP) 开始，用几十分钟复现上面的天气查询例子，获得第一份成就感。参考的教程，动手封装一个你常用、且提供免费API的服务（如查询汇率、搜索新闻）。思考自动化：观察你的学习和工作流程，哪些重复的信息查询、数据处理可以封装成MCP工具，让AI助手替你完成？

【代码】手把手教你写一个mcp获取当前时间服务并本地cherry studio 使用。

使用装饰器暴露函数能力，并通过文档字符串描述功能（供大模型理解用途）：import os"""获取当前用户桌面上的所有文件列表（macOS专属实现）""""""生成个性化问候语（中英双语版）"""return f"🎉 你好。

本文介绍如何写第一个 MCP：用 Node.js + 官方 SDK 实现 add、greet 两个工具，通过 stdio 与 Cursor 通信；在 Cursor 里配置 MCP 后，用 call_mcp_tool 传入 server、toolName、arguments 即可调用。

从这个过程中可以看到，MCP的调用和funtion call没有区别，都是让大模型判断需要使用工具，执行调用。只是MCP协议的出现，让服务的开发，和服务的调用更加方面，MCP帮我们处理连接、调用。让MCP更加容易管理和使用。其中工具怎么执行，并行、串行、TODO执行等智能方面的设计，还是需要开发者根据业务进行处理。

在开始写代码之前，得先解决一个痛点。以前我们要让 GPT 连接外部工具（比如读取文件、搜索网页、操作数据库），通常需要针对不同的 API 写一大堆胶水代码。如果你用LangChain，你得遵循它的接口规范；如果你换个框架，可能全得重写。就是 AI 时代的USB-C 接口。它是由 Anthropic 等公司推动的一个开放标准。MCP Server：提供工具（比如：文件读取服务、微信发布服务）。MCP Client：也就是我们的智能体（负责连接模型和服务端）。LLM：负责决策调用哪个工具。

本文介绍了如何从零开始编写一个名为“Echo”的MCP（Model Context Protocol）服务器。首先，作者建议在动手前仔细阅读MCP官网的介绍，并提供了相关链接。接着，详细说明了环境检查与项目初始化的步骤，包括Node.js版本要求、项目创建、依赖安装以及文件结构设置。随后，文章指导如何构建MCP服务器，包括导入包、设置服务器实例、定义工具和提示功能，并实现主函数来运行服务器。最后，通过使用Cline插件验证服务器的功能，确认服务器成功运行并响应请求。文章结尾提到官方SDK的语言支持，并预告下

这就是一个最简单的MCP（通过@Tool注解表示这个MCP是干嘛的），这样就创建了一个根据城市名称获取天气的一个MCP服务。Spring官网提供了很多依赖。

我们都知道DeepSeek的前身是幻方量化创始人梁文锋为了将人工智能应用于金融交易而打造的，那么是不是可以说DeepSeek炒股很牛b了！！！但问题来了——它炒股还差点啥？你猜到了。没！有！实！时！行！情！你让它来做选股？它说：“请提供一下你关注的股票数据。”你让它判断趋势？它说：“请先提供最近的K线数据。”——这就像你找个理发师，结果他跟你说：“你带把剪刀来。那我就开始琢磨了，要不给它装上实时行情数据，看看它到底能不能干点正事？嗯，还真行。今天我就来教你，。

最近阅读了不少MCP教程，发现许多文章只提供概念和演示示例，却缺少环境配置、编辑器设置等关键步骤。看完后仍然不知从何入手，也不清楚如何开发自己的MCP服务。希望这篇文章能帮助你从0到1入门搭建本地的MCP服务，后续我们解锁更高阶的课程。

你是否想让自己的AI助手拥有专属的“工具箱”？MCP（Model Context Protocol）就是让AI和你的服务无缝对接的桥梁！本教程将手把手教你用Spring Boot开发一个简单的MCP服务。

值得注意的是，如果在AppMall后台MCP管理界面，对某款MCP进行了删除，再重新安装，那么绑定的“密码”——那款http开头的地址就会产生变化，需要在Cherry Studio进行更新，才不会报错。当AI技术的发展和对生活的渗透成为大势所趋，即使不是技术相关岗位的普通人，也值得用开放的心态，挖掘AI工具的价值，尽可能更早、更多地接触AI工具，才能够在时代的浪潮面前，积累“跟得上”的底气。MCP的价值，就是通过类似“外挂”的形式，拓宽大模型本身的能力半径，让大模型成为胜任更多细分应用场景的AI好助手。