进阶·6 分钟阅读·
MCP 入门:做一个只暴露一个工具的本地服务
用最小 MCP Server 理解工具声明、参数校验和客户端连接,先让模型安全调用一个确定能力。
MCPAgent工具调用本地集成
完成后你将能够
- ✓理解 MCP Server 和 Client 的分工
- ✓定义一个参数简单、结果可验证的工具
- ✓知道何时该把本地能力暴露给 AI 助手
步骤 1
先选一个低风险能力
第一次不要从数据库写入、发邮件或部署命令开始。选择只读、可预测的能力,例如查询本地示例数据、返回当前项目说明或格式化一段文本。
工具名称和描述要让模型知道何时使用,也要让人类能快速判断是否越界。MCP 的价值不是把所有能力都给模型,而是把明确能力变成可审计接口。
步骤 2
实现工具和参数校验
按照官方 Build Server 教程建立服务,先注册一个工具,并为参数写清类型、必填项和说明。返回结果尽量结构化,避免只返回一大段不可解析文本。
本地运行后用最小输入、边界输入和错误输入各测一次。尤其要确认参数缺失、类型错误和空结果时不会让模型误以为调用成功。
步骤 3
接入客户端后再扩大能力
把服务接入客户端后,让模型完成一个真实但小的任务,并检查它是否在合适的时机调用工具。如果工具频繁被误用,先改描述和参数,而不是继续增加新工具。
需要读写文件、调用外部系统或处理私有数据时,再补权限边界、日志和人工确认。