使用说明

项目简介

AI Meta MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器,它允许 AI 模型动态地创建和执行自定义工具,从而扩展 AI 的能力。这个服务器提供了一种机制,让 AI 可以在运行时定义新的功能,并通过多种运行时环境(JavaScript, Python, Shell)执行这些工具,所有操作都在沙箱环境中进行,确保安全。

主要功能点

  • 动态工具创建:AI 可以根据需要定义新的工具,无需预先硬编码。
  • 多种运行时环境:支持 JavaScript、Python 和 Shell 脚本的执行,满足不同场景的需求。
  • 沙箱安全:所有工具代码都在隔离的沙箱环境中运行,保障服务器和系统的安全。
  • 工具持久化:自定义工具的定义可以被保存并在会话之间重用,无需重复创建。
  • 灵活的工具管理:提供工具的注册、列表、更新和删除功能,方便管理和维护自定义工具。
  • 人工审批流程:工具的创建和执行可以配置为需要人工审批,增加安全性控制(仓库描述中提到,但代码中未见强制执行的人工审批流程,实际安全性依赖于沙箱和环境配置)。

安装步骤

  1. 确保你的环境中已安装 Node.js 和 npm。
  2. 打开终端,运行以下命令安装 'ai-meta-mcp-server':
    npm install ai-meta-mcp-server

服务器配置

MCP 服务器需要配置在 MCP 客户端中才能使用。以下是一个配置示例,适用于 Claude Desktop 或其他兼容 MCP 协议的客户端。将以下 JSON 配置添加到客户端的 MCP 服务器配置文件中(例如 'claude_desktop_config.json'):

{
  "mcpServers": {
    "ai-meta-mcp": {
      "command": "npx",
      "args": ["ai-meta-mcp-server"],
      "env": {
        "ALLOW_JS_EXECUTION": "true", // 允许 JavaScript 代码执行 (默认启用)
        "ALLOW_PYTHON_EXECUTION": "false", // 允许 Python 代码执行 (默认禁用)
        "ALLOW_SHELL_EXECUTION": "false", // 允许 Shell 命令执行 (默认禁用)
        "PERSIST_TOOLS": "true", // 是否持久化保存工具 (默认启用)
        "TOOLS_DB_PATH": "./tools.json" // 工具数据库文件路径 (默认路径)
      }
    }
  }
}

配置参数说明

  • 'command': 启动 MCP 服务器的命令,这里使用 'npx' 来运行安装在 'node_modules' 中的 'ai-meta-mcp-server'。
  • 'args': 传递给启动命令的参数,这里是 'ai-meta-mcp-server',即服务器的入口文件。
  • 'env': 环境变量配置,用于控制服务器的行为:
    • 'ALLOW_JS_EXECUTION', 'ALLOW_PYTHON_EXECUTION', 'ALLOW_SHELL_EXECUTION': 分别控制是否允许执行 JavaScript, Python 和 Shell 代码,根据需要启用。请注意,启用代码执行功能可能存在安全风险,请在信任的环境中使用。
    • 'PERSIST_TOOLS': 设置为 'true' 时,自定义工具的定义将在服务器重启后仍然保留;设置为 'false' 则不会保存。
    • 'TOOLS_DB_PATH': 指定工具定义保存的文件路径,可以自定义数据库文件的位置。

基本使用方法

  1. 启动服务器:在终端中运行命令 'npx ai-meta-mcp-server' 启动 MCP 服务器。
  2. 配置客户端:将上述服务器配置添加到你的 MCP 客户端配置中,并确保客户端已连接到该服务器。
  3. AI 创建工具:在 MCP 客户端中,指示 AI 创建新的工具。例如,你可以对 AI 说:“创建一个名为 'calculate_area' 的工具,用于计算矩形面积,输入参数为 'width' 和 'height'。” 服务器将通过 'define_function' 工具接收指令并创建新工具。
  4. AI 使用工具:工具创建成功后,AI 就可以在后续的交互中直接调用新创建的工具来执行相应的任务。例如,你可以对 AI 说:“使用 'calculate_area' 工具计算宽度为 5,高度为 10 的矩形面积。”

注意:首次创建工具或更新配置后,可能需要重启 MCP 客户端才能使配置生效。

信息

分类

AI与计算