5ire项目中通过JSON配置文件添加工具的方法解析

在5ire项目中，工具配置是通过JSON文件进行管理的，这为开发者提供了灵活性和便利性。本文将详细介绍如何在5ire项目中通过修改配置文件来添加新工具。

配置文件位置

5ire项目的工具配置存储在名为mcp.json的文件中，其存储位置因操作系统而异：

• macOS系统：配置文件位于~/Library/Application Support/5ire/mcp.json
• Windows系统：通常可以在C:\Users\<YourUsername>\AppData\Roaming\5ire\mcp.json找到

配置文件结构

mcp.json文件采用JSON格式，包含一个servers数组，每个数组元素代表一个工具配置。每个工具配置包含以下关键字段：

1. key：工具的标识符，必须是唯一的（仅包含字母和数字，且不能以数字开头）
2. command：执行工具的主命令（如npx、uvx等）
3. description：工具的描述信息
4. args：传递给命令的参数数组
5. isActive：布尔值，表示工具是否处于激活状态

配置示例

以下是一个典型的配置示例，展示了三种不同类型的工具配置：

{
  "servers": [
    {
      "key": "SequentialThinking",
      "command": "npx",
      "description": "用于结构化思维动态问题解决的MCP服务器工具",
      "args": [
        "-y",
        "--prefer-offline",
        "@modelcontextprotocol/server-sequential-thinking"
      ],
      "isActive": true
    },
    {
      "key": "MacOs",
      "command": "npx",
      "description": "提供macOS特定系统信息和操作的MCP服务器",
      "args": [
        "-y",
        "--prefer-offline",
        "@mcp-get-community/server-macos"
      ],
      "isActive": true
    },
    {
      "key": "Web",
      "command": "uvx",
      "description": "提供网页内容获取功能的MCP服务器",
      "args": [
        "mcp-server-fetch"
      ],
      "isActive": true
    }
  ]
}

添加新工具的步骤

1. 定位到上述提到的配置文件位置
2. 使用文本编辑器打开mcp.json文件
3. 在servers数组中添加新的工具配置对象
4. 确保key字段的值是唯一的
5. 保存文件修改

注意事项

• 修改配置文件时，请确保JSON格式的正确性，否则可能导致5ire无法正确读取配置
• 如果修改后出现问题，可以删除mcp.json文件，5ire会自动重置配置文件
• 建议在修改前备份原始配置文件

通过这种基于JSON的配置方式，开发者可以灵活地管理和扩展5ire项目的工具集，而无需依赖图形界面操作，这为自动化部署和批量配置提供了便利。