项目简介

Agentic Robotics MCP 服务器是 Agentic Robotics 框架的核心组成部分,它将高性能的 Rust 机器人核心与 AI 紧密结合。它负责以标准化的 Model Context Protocol (MCP) 格式与大型语言模型 (LLM) 客户端通信,允许 AI 通过工具调用来感知、决策和控制机器人。该服务器旨在为自主学习和适应性系统提供实时、低延迟的上下文服务。

主要功能点

  • AI 工具托管: 预置 21 种 AI 工具,涵盖机器人控制、传感、规划和学习等,支持 LLM 直接调用。
  • 自然语言控制: 允许通过 Claude、GPT-4 等 LLM 使用自然语言命令机器人。
  • 高性能核心: 基于 Rust 实现,提供微秒级延迟,比传统框架快 10 倍以上,实现实时学习和响应。
  • 记忆与学习: 集成 AgentDB,支持 13,000 倍加速的反射记忆和自动技能整合,让机器人从经验中学习。
  • 跨平台支持: 提供 Linux x64 等平台二进制文件,并通过 Node.js 绑定方便集成。
  • MCP 协议实现: 遵循 MCP 2025-11-15 协议标准,处理初始化、工具列表、工具调用等请求。

安装步骤

  1. 确保您的系统已安装 Node.js (推荐 v18.0.0 或更高版本)。

  2. 打开终端,运行以下命令全局安装 Agentic Robotics:

    npm install -g agentic-robotics

    或者,如果您只想在项目中使用,可以在您的项目目录中运行:

    npm install @agentic-robotics/mcp

    安装完成后,'@agentic-robotics/mcp' 包将作为 MCP 服务器的核心。

服务器配置 (以 Claude Desktop 为例)

MCP 服务器通常由 MCP 客户端(如 Claude Desktop)启动和管理。您需要将以下 JSON 片段添加到您的 Claude Desktop 配置文件 '~/Library/Application Support/Claude/claude_desktop_config.json' 中(路径可能因操作系统而异),以注册 Agentic Robotics MCP 服务器:

{
  "mcpServers": {
    "agentic-robotics": {
      "command": "npx",
      "args": ["@agentic-robotics/mcp"],
      "env": {
        "AGENTDB_PATH": "./robot-memory.db"
      },
      "description": "Agentic Robotics的MCP服务器,用于将LLM连接到机器人系统并提供AI工具和记忆功能。"
    }
  }
}
  • 'agentic-robotics': MCP 服务器的自定义名称,您可以在 Claude 界面中看到。
  • 'command': 启动 MCP 服务器的命令行可执行文件。'npx' 用于运行 Node.js 包中的可执行文件。
  • 'args': 传递给 'command' 的参数。'@agentic-robotics/mcp' 是实际的 MCP 服务器包。
  • 'env': 环境变量,这里配置了 'AGENTDB_PATH',指定机器人记忆数据库的存储位置。
  • 'description': 对 MCP 服务器功能的简要描述。

修改配置后,请重启 Claude Desktop 以加载新的 MCP 服务器。

基本使用方法 (通过 Claude Desktop)

  1. 确保 MCP 服务器已按上述步骤配置并运行(重启 Claude Desktop 后会自动启动)。
  2. 在 Claude Desktop 中,您可以像与机器人对话一样与 AI 交互。例如:
    • "Tell my robot to read the temperature sensor." (让我的机器人读取温度传感器)
    • "Move forward 2 meters, then turn left 90 degrees." (向前移动 2 米,然后左转 90 度)
    • "Go to the kitchen and find the nearest charging station." (去厨房并找到最近的充电站)
  3. Claude 将根据您发送的自然语言命令,通过 MCP 协议调用 Agentic Robotics MCP 服务器提供的相应 AI 工具,从而控制您的机器人。机器人会执行动作并将结果反馈给 Claude。

信息

分类

桌面与硬件