Model Interaction (MCP)

This document introduces how to integrate FIRERPA with large language models using MCP. FIRERPA has implemented the MCP server protocol at the底层 level, allowing you to write custom MCP plugins and serve them via the standard port 65000.

Note

FIRERPA’s built-in MCP service supports tool-calling, resource reading, prompts, progress notifications, and logging.

Attention

Please note that the communication protocols differ between version 8.0 and 9.0 servers: version 9.x uses streamable-http, while version 8.x uses SSE.

Installing the Official Extension

We provide an official MCP service extension. You can download this extension module from extensions/firerpa.py. You may also refer to its implementation to develop or extend your own plugin functionality. After downloading the extension script, upload it to the device’s /data/usr/modules/extension directory via remote desktop or manual push. Then restart the device or restart the FIRERPA service to apply the changes.

Attention

Extension scripts for version 8.0 are not compatible with those for version 9.0. Please strictly confirm your server version and pull the corresponding script from the appropriate GitHub branch.

Using the Official Extension

For Claude, navigate to the Claude settings page and follow the steps illustrated below. Edit the claude_desktop_config.json configuration file as prompted, and add the following MCP JSON service configuration:

{"mcpServers": {"firerpa": {"command": "npx", "args": ["-y", "supergateway", "--streamableHttp", "http://192.168.0.2:65000/firerpa/mcp/"]}}}

Example

For Cursor, open Cursor Settings, follow the instructions in the image below, and enter the following configuration:

{"mcpServers": {"firerpa": {"url": "http://192.168.0.2:65000/firerpa/mcp/"}}}

Example

Attention

Please replace the IP address in the configuration with the actual IP address of your device.

Writing MCP Extensions

Hint

Documentation coming soon. Stay tuned!