LocalDude

LocalDude

一个使用 Model Context Protocol（MCP）SDK 的 Node.js/TypeScript 项目。

GitHub 仓库

此项目托管在 GitHub 上。要克隆仓库：

git clone https://github.com/username/localdude.git
cd localdude

贡献

欢迎贡献！有关如何为此项目做出贡献的详情，请参阅 CONTRIBUTING.md。

安装

npm install

可用脚本

开发

• npm run dev - 在开发模式下启动应用，并在文件更改时自动重新构建
• npm run dev:server - 在开发模式下启动服务，并在文件更改时自动重新构建

构建和运行

• npm run build - 将 TypeScript 文件编译为 JavaScript
• npm run watch - 以监视模式编译 TypeScript 文件（不重启）
• npm run start - 构建并启动主应用
• npm run server - 构建并启动服务

自动重新构建功能

此项目配置为在 TypeScript 文件更改时自动重新构建并重启。此功能通过以下工具实现：

• nodemon：监视文件更改并触发重新构建
• ts-node：直接执行 TypeScript 文件

自动重新构建行为配置在 nodemon.json 中，它会监视以下文件的更改：

• 根目录中的所有 .ts 文件
• src 目录中的所有 .ts 文件（如果该目录存在）

检测到更改时，应用会自动重新构建并重启。

InfluxDB 集成

此项目集成了 InfluxDB，用于时序数据存储和查询。

配置

要使用 InfluxDB 集成，需要在 .env 文件中设置以下环境变量：

INFLUXDB_URL=http://localhost:8086
INFLUXDB_TOKEN=your_influxdb_token
INFLUXDB_ORG=your_organization
INFLUXDB_BUCKET=your_bucket

你可以从 .env.example 文件中复制这些变量，并将占位值替换为实际的 InfluxDB 连接信息。

可用的 InfluxDB 工具

此服务提供以下工具来与 InfluxDB 交互：

1. influxdb-query：执行自定义 Flux 查询

   {
     "query": "from(bucket: \"your_bucket\") |> range(start: -1h) |> filter(fn: (r) => r._measurement == \"your_measurement\")"
   }
   

2. influxdb-latest：获取某个 measurement 和字段的最新数据点

   {
     "measurement": "your_measurement",
     "field": "your_field",
     "timeRange": "-1h"  // optional, defaults to "-1h"
   }
   

3. influxdb-range：获取指定时间范围内的数据

   {
     "measurement": "your_measurement",
     "field": "your_field",
     "start": "-1h",
     "stop": "now()"  // optional, defaults to "now()"
   }
   

可以通过 MCP 服务接口使用这些工具查询 InfluxDB 数据库。