MCP 怎么接大模型Model Context Protocol 接入教程Agent 想读文件、查数据库、调内部接口早期每个工具都得自己写一套适配代码。MCPModel Context Protocol把「模型 ↔ 工具」的协议统一了只要工具实现了 MCP server任何支持 MCP 的客户端都能直接用。这篇文章讲怎么在应用里接上 MCP server让大模型调起真实工具。MCP 在架构里的位置大模型 ↑ 函数调用function calling 应用客户端把 MCP 工具转成函数 schema ↑ MCP 协议 MCP server文件系统 / 数据库 / 内部 API …MCP server 暴露三类能力tools可执行的动作、resources可读取的数据、prompts预设提示。我们最常用的是 tools。环境准备pipinstallmcp openai# 以官方 filesystem server 为例pipinstallmcp-server-filesystem启动一个文件系统 MCP serverstdio 方式# 让 server 能访问 /data 目录python-mmcp_server_filesystem /data客户端列出工具并转成函数 schemaimportasynciofrommcpimportClientSession,StdioServerParametersfrommcp.client.stdioimportstdio_clientasyncdeflist_tools():server_paramsStdioServerParameters(commandpython,args[-m,mcp_server_filesystem,/data],)asyncwithstdio_client(server_params)as(read,write):asyncwithClientSession(read,write)assession:awaitsession.initialize()toolsawaitsession.list_tools()fortintools.tools:print(t.name,→,t.description)returntools.tools toolsasyncio.run(list_tools())把工具交给大模型调用拿到工具后转成 OpenAI 的函数定义让模型决定什么时候调fromopenaiimportOpenAIdefto_function_schema(tool):return{type:function,function:{name:tool.name,description:tool.descriptionor,parameters:tool.inputSchema,},}clientOpenAI(api_keyYOUR_API_KEY,base_urlYOUR_BASE_URL)messages[{role:user,content:把 /data/report.txt 的前 5 行读出来}]respclient.chat.completions.create(modelYOUR_MODEL,messagesmessages,tools[to_function_schema(t)fortintools],)执行模型选中的工具再把结果喂回去importjson tool_callresp.choices[0].message.tool_calls[0]nametool_call.function.name argsjson.loads(tool_call.function.arguments)# 真正执行 MCP 工具asyncdefcall_tool(name,args):server_paramsStdioServerParameters(commandpython,args[-m,mcp_server_filesystem,/data])asyncwithstdio_client(server_params)as(read,write):asyncwithClientSession(read,write)assession:awaitsession.initialize()returnawaitsession.call_tool(name,args)resultasyncio.run(call_tool(name,args))# 把工具结果回传给模型让它生成最终回答messages.append(resp.choices[0].message)messages.append({role:tool,tool_call_id:tool_call.id,content:str(result.content),})finalclient.chat.completions.create(modelYOUR_MODEL,messagesmessages)print(final.choices[0].message.content)Agent 循环多轮工具调用真实 Agent 会反复「模型选工具 → 执行 → 回传」直到模型不再调用工具whileTrue:respclient.chat.completions.create(modelYOUR_MODEL,messagesmessages,toolsfunction_schemas)msgresp.choices[0].messageifnotmsg.tool_calls:print(msg.content)breakmessages.append(msg)forcallinmsg.tool_calls:outasyncio.run(call_tool(call.function.name,json.loads(call.function.arguments)))messages.append({role:tool,tool_call_id:call.id,content:str(out.content)})安全工具别裸奔MCP 让模型能执行真实动作权限必须收口风险做法模型删库只暴露只读工具写操作加人工确认越权读文件server 根目录锁死禁止..逃逸工具参数注入校验参数类型与范围无限循环限制最大工具调用轮数快速排错表问题可能原因解决方法连不上 server命令/路径错先本地手动起 server工具列表为空没 initialize调用前session.initialize()模型不调工具schema 描述差写清名称与用途参数解析失败类型不符按 inputSchema 校验死循环无轮数上限限制最大调用次数执行报错权限不足检查 server 目录/账号结果太大返回超长工具侧截断再回传超时工具太慢设客户端超时配置检查清单检查项怎么确认server 能独立启动手动运行无报错工具 schema 清晰名称/描述/参数齐全权限最小化只读优先、写操作确认轮数有上限防止无限循环参数校验类型与范围都检查结果截断大返回先裁剪超时设置慢工具不卡死日志留痕每次调用可回溯MCP 的价值是把「接工具」从体力活变成标准协议。客户端负责把 MCP 工具转成函数调用模型负责决定何时调用你负责把权限收口。三层各管各的Agent 就能稳稳跑起来。