news 2026/11/5 1:02:52

AI学习：什么是MCP，写第一个MCP

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
AI学习：什么是MCP，写第一个MCP

什么是MCP？

MCP（Model Context Protocol）是一个开放的协议标准，用于连接AI助手（如Claude、GPT等）与外部工具和数据源。它定义了一套标准化的通信方式，让AI助手能够安全、可靠地调用外部服务。

MCP的核心概念

1. 客户端-服务器架构

  • 客户端：AI助手（如Claude Desktop、VS Code插件等）
  • 服务器：提供工具和资源的外部服务
  • 通信方式：通过标准输入输出进行JSON-RPC 2.0协议通信

2. 传输协议

  • 使用JSON-RPC 2.0作为通信协议
  • 通过stdin/stdout进行数据传输
  • 每行一个JSON对象，以换行符分隔

MCP基本语法规范

1. 初始化请求initialize

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{"tools":{}},"clientInfo":{"name":"Claude Desktop","version":"1.0.0"}}}

2. 工具列表请求tools/list

{"jsonrpc":"2.0","id":2,"method":"tools/list"}

3. 工具调用请求tools/call

{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"calculate","arguments":{"expression":"2+3*4"}}}

4. 响应格式

{"jsonrpc":"2.0","id":3,"result":{"content":[{"type":"text","text":"计算结果：14"}]}}

MCP服务器实现要点

1. 必需的方法

  • initialize：服务器初始化
  • tools/list：返回可用工具列表
  • tools/call：执行具体的工具调用

2. 工具定义结构

{"name":"工具名称","description":"工具描述","inputSchema":{"type":"object","properties":{"参数名":{"type":"参数类型","description":"参数描述"}},"required":["必需参数列表"]}}

3. 错误处理

{"jsonrpc":"2.0","id":请求ID,"error":{"code":错误代码,"message":"错误描述"}}

MCP服务器例子

#!/usr/bin/env python3 #-*-coding:utf-8-*-""" 简单的MCP服务器示例 提供基本的计算工具"""importjsonimportsysfromtypingimportDict,Any,List,OptionalclassSimpleMCPServer:"""简单的MCP服务器实现"""def__init__(self):self.tools={"calculate":{"name":"calculate","description":"执行简单的数学计算","inputSchema":{"type":"object","properties":{"expression":{"type":"string","description":"要计算的数学表达式，如 '2+3*4'"}},"required":["expression"]}},}defhandle_request(self,request:Dict[str,Any])->Dict[str,Any]:"""处理MCP请求"""method=request.get("method")ifmethod=="initialize":returnself._handle_initialize(request)elif method=="tools/list":returnself._handle_tools_list(request)elif method=="tools/call":returnself._handle_tools_call(request)else:return{"jsonrpc":"2.0","id":self._get_request_id(request),"error":{"code":-32601,"message":f"未知方法: {method}"}}def_handle_initialize(self,request:Dict[str,Any])->Dict[str,Any]:"""处理初始化请求"""return{"jsonrpc":"2.0","id":self._get_request_id(request),"result":{"protocolVersion":"2024-11-05","capabilities":{"tools":{}},"serverInfo":{"name":"SimpleMCPServer","version":"1.0.0"}}}def_handle_tools_list(self,request:Dict[str,Any])->Dict[str,Any]:"""处理工具列表请求"""return{"jsonrpc":"2.0","id":self._get_request_id(request),"result":{"tools":list(self.tools.values())}}def_handle_tools_call(self,request:Dict[str,Any])->Dict[str,Any]:"""处理工具调用请求"""params=request.get("params",{})tool_name=params.get("name")arguments=params.get("arguments",{})try:iftool_name=="calculate":result=self._calculate(arguments.get("expression",""))else:return{"jsonrpc":"2.0","id":self._get_request_id(request),"error":{"code":-32601,"message":f"未知工具: {tool_name}"}}return{"jsonrpc":"2.0","id":self._get_request_id(request),"result":{"content":[{"type":"text","text":json.dumps(result,ensure_ascii=False,indent=2)}]}}except Exceptionase:return{"jsonrpc":"2.0","id":self._get_request_id(request),"error":{"code":-32603,"message":f"工具执行错误: {str(e)}"}}def_calculate(self,expression:str)->Dict[str,Any]:"""执行数学计算"""try:# 安全的数学表达式计算 allowed_chars=set("0123456789+-*/.() ")ifnotall(cinallowed_charsforcinexpression):raiseValueError("表达式包含不允许的字符")result=eval(expression)return{"expression":expression,"result":result,"type":"number"}except Exceptionase:raiseValueError(f"计算错误: {str(e)}")def_get_request_id(self,request:Dict[str,Any])->Any:"""获取请求ID，如果请求中没有ID则返回默认ID"""if"id"inrequest:returnrequest["id"]else:# 如果请求中没有id，返回一个默认的字符串IDreturn"default-id"defrun(self):"""运行MCP服务器"""print("Simple MCP Server 启动中...",file=sys.stderr)try:forlineinsys.stdin:line=line.strip()ifnot line:continuetry:request=json.loads(line)response=self.handle_request(request)print(json.dumps(response,ensure_ascii=True))sys.stdout.flush()except json.JSONDecodeError:error_response={"jsonrpc":"2.0","id":"default-id","error":{"code":-32700,"message":"解析错误"}}print(json.dumps(error_response,ensure_ascii=False))sys.stdout.flush()except KeyboardInterrupt:print("服务器关闭",file=sys.stderr)if__name__=="__main__":server=SimpleMCPServer()server.run()

简单计算器MCP服务器

本项目中的simple_mcp_server.py是一个完整的MCP服务器示例，包含：

  1. 数学计算工具：执行基本数学表达式
  2. 文本统计工具：分析文本的字符、单词等统计信息
  3. 系统信息工具：获取Python和系统基本信息

可以通过以下方式测试：

# 启动服务器python simple_mcp_server.py# 在另一个终端测试echo'{"jsonrpc":"2.0","id":1,"method":"tools/list"}'|python simple_mcp_server.py

真实cursor上加配置调用即可
{“mcpServers”:{“my-server”:{“command”:“python”,“args”:[“D:/sase-dfx/sase_dfx/9、ai生成/simple_mcp_server.py”],“disabled”:false,“alwaysAllow”:[“calculate”]}}}

版权声明: 本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若内容造成侵权/违法违规/事实不符，请联系邮箱：809451989@qq.com进行投诉反馈，一经查实，立即删除！
网站建设 2026/11/5 1:54:41

ModbusTCP转CC-Link网关解锁直线电机性能上限

在内嵌式直线电机的应用领域，无锡耐特森ModbusTCP转CClink网关的应用显得尤为重要。内嵌式直线电机以其高精度、高稳定性的特点，广泛应用于半导体制造、精密机械加工等高端设备中。然而，这些设备的高效运行离不开稳定可靠的通讯系统&#xff…

作者头像 李华
网站建设 2026/11/5 16:35:24

使用树莓派打造语音控制家居的超详细版教程

用树莓派从零打造一个真正“听懂你话”的语音控制系统 还记得第一次对智能音箱说“打开灯”，它真的回应并亮起时的那种兴奋吗？但随之而来的，是隐私的隐隐担忧——我的声音去了哪里？断网了还能不能用？能不能让它听懂我…

作者头像 李华
网站建设 2026/11/3 5:11:23

树莓派4b引脚功能图入门指南：超详细版图示讲解

树莓派4B引脚全解析：从零开始掌握GPIO与通信接口的实战指南你有没有过这样的经历？手握一块树莓派4B，满心欢喜地接上传感器，结果LED不亮、屏幕无显示、串口收不到数据……最后发现，问题竟出在一根线接错了引脚。别担心&…

作者头像 李华
网站建设 2026/11/4 19:32:27

cc2530多设备联动控制：图解说明原理

用 CC2530 搞定多设备联动：从芯片到群控的实战解析你有没有遇到过这样的场景？家里客厅的灯、走廊的灯、阳台的灯，想一起开关，但布线复杂、改起来麻烦；或者农业大棚里多个区域要根据温湿度自动启停风机和灌溉系统&#…

作者头像 李华
网站建设 2026/11/5 7:48:28

Windows快捷键冲突终极排查指南：一键定位占用程序

Windows快捷键冲突终极排查指南：一键定位占用程序 【免费下载链接】hotkey-detective A small program for investigating stolen hotkeys under Windows 8 项目地址: https://gitcode.com/gh_mirrors/ho/hotkey-detective 还在为按下CtrlS却无法保存文档而烦…

作者头像 李华
网站建设 2026/11/4 22:23:43

1001110

011010

作者头像 李华