Korean | 한국어

개요

ElephantRobotics MyCobot 시리즈 로봇 팔 (특히 ultraArmP340에 최적화)에 대한 천연 언어 제어를 제공하는 모델 콘텍스 프로토콜 (MCP) 서버 구현. 이 서버는 대화 형 AI를 통해 로봇 팔을 제어 할 수 있으며 로봇은 누구나 액세스 할 수 있습니다.

특징

• 여러 MyCobot 모델 지원 (ultraArmP340, MyCobot280, MyCobot320)
• MCP 프로토콜을 통한 자연적인 언어 통제
• 물리적 하드웨어없이 개발을위한 ≯ 시뮬레이션 모드
• ️ 안전기능
• 실시간 상태 모니터링

부품

도구

서버는 다음과 같은 제어 도구를 제공합니다:

연결 관리

• connect robot - 로봇 팔에 연결
• 입력: model (문자): 로봇 모델
• 입력: port (string): 직렬 포트
• 반환: 연결 상태

상태 감시

• get robot status - 현재 로봇 상태를 가져옵니다
• 반환: 현재 각, 협조, 그리퍼/펌프 국가, 운동 상태

운동 통제

• move to angles - 특정 각도로 관절 이동
• 입력: angles (array): 각 합동을 위한 표적 각
• 입력: speed (int): 운동 속도

RobotArm MCP P340

English | 中文

Overview

A Model Context Protocol (MCP) server implementation that provides natural language control for ElephantRobotics MyCobot series robotic arms (especially optimized for ultraArmP340). This server enables controlling robotic arms through conversational AI, making robotics accessible to everyone.

Features

• 🤖 Support for multiple MyCobot models (ultraArmP340, MyCobot280, MyCobot320)
• 🎮 Natural language control via MCP protocol
• 🔧 Simulation mode for development without physical hardware
• 🛡️ Safety features including emergency stop
• 📊 Real-time status monitoring

Components

Tools

The server provides the following control tools:

Connection Management

• connect_robot - Connect to a robotic arm
  • Input: model (string): Robot model
  • Input: port (string): Serial port
  • Returns: Connection status

Status Monitoring

• get_robot_status - Get current robot status
  • Returns: Current angles, coordinates, gripper/pump state, movement status

Movement Control

• move_to_angles - Move joints to specific angles

  • Input: angles (array): Target angles for each joint
  • Input: speed (int): Movement speed
  • Returns: Movement confirmation

• move_to_coords - Move to specific coordinates

  • Input: coords (array): Target coordinates
  • Input: speed (int): Movement speed
  • Returns: Movement confirmation

End Effector Control

• control_gripper - Control gripper open/close
• control_pump - Control suction pump on/off

System Commands

• go_zero - Return robot to zero position
• emergency_stop - Emergency stop all movements

Advanced Motion Control

• execute_action_sequence - Execute custom action sequences
  • Input: sequence_name (string): Descriptive name for the sequence
  • Input: actions (array): List of actions, each containing:
    • type: Action type (“angles”, “coords”, “gripper”, “pump”, “wait”)
    • angles/coords: Target position (based on type)
    • speed: Movement speed (optional, default 50)
    • duration: Action duration in seconds (optional)
    • gripper_action: “open” or “close” (for gripper type)
    • pump_action: “on” or “off” (for pump type)
    • Input: default_interval (float): Default interval between actions (optional, default 0.5s)
  • Returns: Execution status with completed actions count
  • Note: This tool enables complex behaviors like cat playing, circle drawing, dancing, and custom gestures through action sequences

Resources