跳到主要内容

输入关键词,快速查找站内精选内容。

← 返回教程
进阶·6 分钟阅读·

MCP 入门:做一个只暴露一个工具的本地服务

用最小 MCP Server 理解工具声明、参数校验和客户端连接,先让模型安全调用一个确定能力。

MCPAgent工具调用本地集成

完成后你将能够

  • 理解 MCP Server 和 Client 的分工
  • 定义一个参数简单、结果可验证的工具
  • 知道何时该把本地能力暴露给 AI 助手

步骤 1

先选一个低风险能力

第一次不要从数据库写入、发邮件或部署命令开始。选择只读、可预测的能力,例如查询本地示例数据、返回当前项目说明或格式化一段文本。

工具名称和描述要让模型知道何时使用,也要让人类能快速判断是否越界。MCP 的价值不是把所有能力都给模型,而是把明确能力变成可审计接口。

步骤 2

实现工具和参数校验

按照官方 Build Server 教程建立服务,先注册一个工具,并为参数写清类型、必填项和说明。返回结果尽量结构化,避免只返回一大段不可解析文本。

本地运行后用最小输入、边界输入和错误输入各测一次。尤其要确认参数缺失、类型错误和空结果时不会让模型误以为调用成功。

步骤 3

接入客户端后再扩大能力

把服务接入客户端后,让模型完成一个真实但小的任务,并检查它是否在合适的时机调用工具。如果工具频繁被误用,先改描述和参数,而不是继续增加新工具。

需要读写文件、调用外部系统或处理私有数据时,再补权限边界、日志和人工确认。