MAVLinkMCP

MAVLinkMCP

5
os_automation

The MAVLink MCP Server is a Python-based Model Context Protocol server enabling interaction with MAVLink-enabled devices, such as drones running PX4 software. It includes an example AI agent client for drone control, using the fastagent library.

MAVLink MCP Server

This repository contains a Python-based Model Context Protocol (MCP) server for interacting with MAVLink-enabled devices, such as drones running PX4 software.

Prerequisites

  • Python 3.10 or higher

Installation

  1. Clone the repository:

    git clone https://github.com/yourusername/MAVLinkMCP.git
cd MAVLinkMCP

  2. Install dependencies:

    pip install -r requirements.txt

Usage

Run the MCP server with the following command:

python src/server/mavlinkmcp.py

Alternatively, you can run the server using uv run:

uv run src/server/mavlinkmcp.py

Example agent usage

An example client is implemented in example_agent.py using the fastagent library. This demonstrates how to create an AI agent that interacts with the MCP server and supports human input for controlling a drone. Export the OpenAI key before running it.

Contributing

Contributions are welcome! Please fork the repository and submit a pull request.

License

This project is licensed under the MIT License. See the LICENSE file for details.