5ire项目中自定义MCP工具的配置与使用指南

什么是MCP工具

MCP(模型控制协议)工具是5ire项目中一个强大的功能扩展机制，允许开发者创建自定义工具并与语言模型集成。通过MCP，开发者可以扩展语言模型的能力，使其能够执行特定的计算任务或访问外部功能。

自定义MCP工具的创建步骤

1. 编写MCP服务脚本

开发者需要创建一个Python脚本，使用FastMCP框架定义工具函数。以下是一个计算BMI的示例：

from mcp.server.fastmcp import FastMCP

# 创建MCP服务器实例
mcp = FastMCP("my_custom_mcp")

@mcp.tool()
def calculate_bmi(weight_kg: float, height_m: float) -> float:
    """计算给定体重(kg)和身高(m)的BMI指数
    
    参数:
        weight_kg (float): 体重，单位为千克
        height_m (float): 身高，单位为米
    
    返回:
        float: 身体质量指数(BMI)值
    """
    return weight_kg / (height_m ** 2)

if __name__ == "__main__":
    mcp.run()

2. 配置MCP服务器

在5ire的配置目录(AppData\Roaming\5ire)中创建或修改mcp.json文件，添加自定义工具的配置：

{
  "servers": [
    {
      "name": "my_mcp_bmi",
      "key": "bmicalc",
      "description": "根据体重(kg)和身高(m)计算BMI",
      "command": "python",
      "args": [
        "C:\\path\\to\\your\\mcp_script.py"
      ],
      "isActive": true
    }
  ]
}

关键配置项说明：

• name: 工具的唯一标识名称
• key: 调用时使用的关键字
• description: 工具的功能描述
• command: 启动工具的命令(如python)
• args: 传递给命令的参数(脚本路径)
• isActive: 是否激活该工具

使用注意事项

1. 工具功能默认禁用：5ire项目中，LM Studio和Ollama的工具功能默认是禁用的，需要在设置中手动启用。

2. 调试技巧：

   • 确保MCP服务脚本能够正常运行
   • 检查5ire的检查器(inspector)查看工具调用情况
   • 使用清晰的工具描述帮助语言模型理解功能

3. 调用方式：在启用工具功能后，可以通过自然语言描述需要执行的计算或任务，语言模型会自动识别并调用合适的工具。

实际应用示例

配置完成后，用户可以向语言模型提问如"我的BMI是多少？我体重70kg，身高1.75m"，语言模型会自动调用配置的BMI计算工具并返回结果。

总结

5ire项目的MCP工具机制为开发者提供了强大的扩展能力，通过简单的Python脚本和配置即可为语言模型添加自定义功能。掌握这一技术可以显著提升语言模型在实际应用中的实用性和灵活性。