LocalDude
@jussikin
MCP server that allows accessing influxdb to read sensor from there in. Perhaps later some more active functionalities like sending mqtt messages.
Overview
What is LocalDude?
LocalDude is a Node.js/TypeScript project built with the Model Context Protocol (MCP) SDK that provides an MCP server with InfluxDB integration for time-series data storage and querying. It is intended for developers who need to interact with InfluxDB through MCP tools.
How to use LocalDude?
Install dependencies with npm install, configure InfluxDB environment variables in a .env file (INFLUXDB_URL, INFLUXDB_TOKEN, INFLUXDB_ORG, INFLUXDB_BUCKET), then use npm run dev for development with auto-rebuild or npm run server to build and start the server. The server exposes MCP tools such as influxdb-query, influxdb-latest, and influxdb-range for querying and retrieving data.
Key features of LocalDude
- MCP server for interacting with InfluxDB
- Execute custom Flux queries via
influxdb-query - Retrieve latest data point with
influxdb-latest - Query data within time ranges via
influxdb-range - Auto-rebuild on TypeScript file changes during development
- Configuration via environment variables
Use cases of LocalDude
—
FAQ from LocalDude
What dependencies does LocalDude require?
LocalDude requires Node.js and npm. It uses the MCP SDK, InfluxDB client, and development tools like nodemon and ts-node.
How do I configure the InfluxDB connection?
Set the environment variables INFLUXDB_URL, INFLUXDB_TOKEN, INFLUXDB_ORG, and INFLUXDB_BUCKET in a .env file. An .env.example file is provided with placeholder values.
How do I run LocalDude in development mode?
Use npm run dev to start the application with auto-rebuild on file changes, or npm run dev:server to start only the server in development mode.
Can I contribute to LocalDude?
Yes, contributions are welcome. See the CONTRIBUTING.md file for details on how to contribute to the project.
What transport does the MCP server use?
—
