Fledge MCP

🚀 Fledge Model Context Protocol (MCP) Server

Fledge-MCP is a WebSocket-based JSON-RPC 2.0 implementation for connecting models to the Fledge platform. It enables models to interact with Fledge through a standard interface.

🚀 Quick Start

Prerequisites

• Docker installed
• Smithery.ai account
• Smithery CLI tool installed

📦 Installation

Method 1: Compile from Source

1. Clone the repository:

git clone https://github.com/fledge-mcp/fledge-mcp-server.git
cd fledge-mcp-server

2. Compile and run:

npm install
node index.js

Method 2: Use Docker Image

docker pull fledge/mcp-server
docker run -it --rm fledge/mcp-server

💻 Running the Server

By default, the server listens on port 8082.

Command-line Arguments

• -p: Specify the API port, default is 8081.
• -H: Set the Fledge host address, default is localhost.
• --version: Display version information and exit.
• --help: Display help information and exit.

💻 Usage Examples

Connecting to Cursor

Initializing the Connection

{
    "jsonrpc": "2.0",
    "method": "initialize",
    "params": {},
    "id": "1"
}

Listing Tools

{
    "jsonrpc": "2.0",
    "method": "tools/list",
    "params": {},
    "id": "2"
}

Available Tools

Sensor Data Retrieval

async getSensorData(sensorId, limit) => {
    // Implementation of retrieving sensor data
}

Device Status Query

async getDeviceStatus(deviceId) => {
    // Implementation of querying device status
}

Testing the API

Installing Test Dependencies

npm install -D npm-run-scripts

Running Tests

npm test

📚 Documentation

Production Considerations

• Configure HTTPS
• Use a reverse proxy (e.g., Nginx)
• Implement stronger authentication (JWT, OAuth)
• Add rate limiting
• Set up persistent subscription storage

Deployment on Smithery.ai

Prerequisites

• Docker installed
• Smithery.ai account
• Smithery CLI tool installed

Deployment Steps

# Build the image
docker build -t fledge-mcp .

# Deploy to Smithery
smithery deploy

Monitoring and Updates

• View real-time logs: smithery logs fledge-mcp
• Update the deployment: smithery deploy --update

JSON-RPC Protocol Support

Initialization Method

{
    "jsonrpc": "2.0",
    "method": "initialize",
    "params": {},
    "id": "1"
}

Tool Listing Method

{
    "jsonrpc": "2.0",
    "method": "tools/list",
    "params": {},
    "id": "2"
}

Error Codes

• -32700: Parse error
• -32600: Invalid request
• -32601: Method not found
• -32602: Invalid parameters
• -32000: Server error

For further assistance, please refer to the Fledge-MCP documentation or join our Developer Community.