MCP Tool模块详解
摘要
MCP Tool模块是模型上下文协议的核心组件,通过标准化接口将函数/类转换为AI可调用的工具,实现模型与外部系统的安全交互。支持JSON-RPC 2.0跨语言调用、独立进程隔离、动态发现和多传输协议,适用于医疗、电商等领域的复杂系统集成。
核心特性
- 标准化接口
遵循JSON-RPC 2.0协议,实现跨语言调用 - 安全隔离架构
工具运行在独立进程中,防止敏感数据泄露 - 动态发现机制
支持工具能力的自动注册与发现 - 多传输协议支持
兼容stdio、HTTP SSE等多种通信方式
典型实现示例
基础工具注册
通过装饰器将普通函数转换为MCP工具:
from mcp.server.fastmcp import FastMCP
mcp = FastMCP("MathServer")@mcp.tool()
def add(a: int, b: int) -> int:"""执行两数相加"""return a + b@mcp.tool()
def sqrt(x: float) -> float:"""计算平方根"""return x ** 0.5
创建数学工具集,支持AI模型调用基础运算功能
企业级应用案例
医疗健康领域多源数据整合工具:
class PatientRecordsTool:def __init__(self, db_conn):self.db = db_conn@mcp.tool()def get_lab_results(self, patient_id: str):"""查询患者检验报告"""return self.db.execute(f"SELECT * FROM labs WHERE patient='{patient_id}'")@mcp.tool() def check_medication(self, drug_name: str):"""检查药物相互作用"""return requests.get(f"https://drug-api.example.com/check?name={drug_name}")
实现电子病历查询与药品安全检测的自动化集成
复杂工具链组合
电商场景下的多工具协同:
@mcp.tool()
def recommend_products(user_prefs: dict):"""基于用户画像推荐商品"""inventory = get_inventory_tool() # 调用库存工具return [item for item in inventory if item["category"] in user_prefs["interests"]]
通过工具组合实现个性化推荐,展示模块化设计优势
开发建议
- 工具定义规范
- 包含清晰的类型注解和文档字符串
- 安全防护措施
- 敏感操作实现权限验证层
- 部署最佳实践
- 推荐使用容器化部署保证隔离性