BioT Speech IoT LLM App

MCP数据服务

提供方 FHDW-Hannover-IoT

数据服务 stdio · 本地进程 无需鉴权 社区 / 第三方 Claude
查看接入方式

BioT传感器助手是一个基于Python的后端服务,提供LLM代理、传感器数据处理和MQTT订阅功能,适用于物联网数据分析场景。

一句话选型结论

按资料字段整理

BioT Speech IoT LLM App 属于数据服务类 MCP 服务器,stdio · 本地进程,无需鉴权,可直接接入 Claude,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类数据服务 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 1 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

数据服务
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量1暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

物联网Python本地部署传感器数据分析LLM代理MQTTFastAPI

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
uv run python -m app.main

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 1 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
数据库查询

用自然语言查库、取数,不用手写 SQL。

数据同步与清洗

把多来源数据拉到一处做整理。

报表取数

按口径快速拉出统计结果。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 1 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Claude,换客户端不用重新研究配置。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在数据服务场景里让模型直接调用外部能力的人。
  • 已经在用 Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
BioT Speech IoT LLM App当前 1 stdio · 本地进程 本地部署 有 2026-05-17
Memory 9d25f64e 9 未标注 未标注 无 2026-05-17
Getzep MCP 9 stdio · 本地进程 本地部署 有 2026-05-17
anything-llm 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Prisma MCP Server 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Astr Bot 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

数据服务
字段来自项目仓库与公开索引,中文说明由本站标注
提供方FHDW-Hannover-IoT上游标注的维护方 FHDW-Hannover-IoT
分类数据服务本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

12.1 KB
来自项目仓库与上游目录的原文,未做删改

生物T传感器助手(LLM_App)

BioT Speech IoT项目的Python后端。主持人:

  1. A. FastAPI服务器 这暴露了 POST /chat 对于Android应用程序。
  2. 一 LLM代理 (提供者不可知——Anthropic、OpenAI、DeepSeek、Gemini)。
  3. A. 正确的MCP服务器 (FastMCP,流式HTTP,端口8002),暴露
    传感器查询工具。
  4. 一 MQTT用户 将实时传感器读数镜像到SQLite中
    代理可以查询的数据库。

> 系统角色: 这是BioT拆分的服务器端。
> Android应用程序是客户端,它拥有手机上的Room数据库
> 实时图表。服务器的SQLite是一个单独的并行视图
> 相同的MQTT数据,仅由LLM使用。看 数据库架构.


目录

  1. 建筑
  2. 数据库架构
  3. 先决条件
  4. 快速开始
  5. 端点
  6. 项目布局
  7. 环境变量
  8. 切换LLM提供者
  9. 添加新的MCP工具
  10. 故障排除

建筑```

┌──────────────────────────────┐
│ Android app (BioT_Speech_IoT_App)
│ - Voice → VoiceCommandResolver
│ - QUERY_ + UNKNOWN → LlmQueryHandler
│ │
└──────┼───────────────────────┘
│ POST /chat { "message": "..." }
▼
┌────────────────────────────────────────┐
│ app/main.py (FastAPI, port 8001) │
│ ├── /health │
│ └── /chat ─► SensorAgent.run() │
│ │ │
│ ▼ │
│ app/agent.py │
│ (provider-agnostic) │
└──────┬─────────────────────┬────────────┘
│ HTTP │ tool calls
▼ ▼
┌───────────────────────────┐ ┌───────────────────────────┐
│ Anthropic / OpenAI / │ │ mcp_server/ │
│ DeepSeek / Gemini API │ │ sensor_mcp_server.py │
│ (chosen by LLM_PROVIDER) │ │ FastMCP, port 8002 │
└───────────────────────────┘ └────────────┬───────────────┘
│ SELECT
▼
┌────────────────────────────┐
│ data/sensor_database.db │
│ (SQLite, read-only by MCP)│
└────────────▲───────────────┘
│ INSERT
┌─────────────────────┴─────────────────┐
│ mcp_server/mqtt_subscriber.py │
│ (background thread inside FastAPI) │
└─────────────────▲─────────────────────┘
│ subscribes Sensor/

│
┌─────────────────┴─────────────────────┐
│ Mosquitto MQTT broker │
└─────────────────▲─────────────────────┘
│ publishes Sensor/*
┌─────────────────┴─────────────────────┐
│ ESP8266 + MPU-6050 + A3144 │
└───────────────────────────────────────┘


MCP服务器作为 **子进程** FastAPI服务器-- `app/main.py`
在FastAPI生命周期启动期间生成它。代理通过HTTP到达它
上 `localhost:8002`。要公开部署,请更改 `MCP_SERVER_URL` 在 `.env`
而无需更改任何代码。

______________________________________________________________________

## 数据库架构

BioT系统具有 **两个SQLite数据库**。这是故意的
记录在这里,所以看起来不像是bug。

|数据库|位置|编写人|读取人|目的|
|---|---|---|---|---|
| **房间(电话)** | `/data/data/com.fhdw.biot.speech.iot/databases/sensor_database` |安卓 `MainActivity` 从MQTT消息|所有图表活动通过 `LiveData` |反应式UI、离线图表、日期过滤器|
| **服务器SQLite** | `LLM_App/data/sensor_database.db` | `mqtt_subscriber.py` 从MQTT消息|MCP工具(只读)|LLM历史查询、异常分析|

两个数据库都使用 **相同的模式** (参见 `mqtt_subscriber._ensure_db_schema`)
因此,代理的SQL查询对任何一个都以相同的方式工作。他们都订阅了
对于相同的MQTT主题,它们只是写入不同的文件。

**为什么没有一个DB?**

- Room位于Android应用沙箱中。MCP服务器无法访问它
没有 `adb pull`.
- 将Room从Android应用程序中删除意味着重写每个图表
活动(`AccelActivity`, `GyroActivity`, `MagnetActivity`,
`MainGraphActivity`)从HTTP端点获取数据,并会破坏离线图表。
- 两个DB的“额外”成本是一个后台线程(`mqtt_subscriber`)那个
不管怎样,他一直在跑步。与MQTT相比,磁盘开销可以忽略不计
系统处理的消息量。

______________________________________________________________________

## 先决条件

- Python 3.10+https://www.python.org/downloads/
- `uv` (Astral的软件包管理器)。通过PowerShell安装:```powershell
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"
  • Mosquitto MQTT代理在同一台机器上运行(或可在局域网上访问)
  • API密钥来自其中之一:Anthropic/OpenAI/DeepSeek/Gemini

快速开始```powershell

1. Clone and enter the project

cd C:\Users\Arun\Documents\School\BioT_Speech_IoT_LLM_App

2. Create a virtualenv and install dependencies

uv venv
.venv\Scripts\Activate.ps1
uv sync

3. Configure

copy .env.example .env

… edit .env and set LLM_API_KEY

4. Make sure Mosquitto is running

net start mosquitto

5. Start the FastAPI server (which launches the MCP server + MQTT subscriber)

uv run python -m app.main


您应该看到以下日志行:```
INFO  | biot.app.main | Starting MCP sensor server on port 8002
INFO  | biot.app.main | MCP server ready at http://localhost:8002/mcp
INFO  | biot.app.main | Agent ready (provider=anthropic, model=claude-sonnet-4-6, mcp=http://localhost:8002/mcp)
INFO  | biot.app.main | MQTT subscriber running (broker=127.0.0.1:1883)
INFO  | uvicorn.error | Application startup complete.

快速烟雾测试:``powershell curl.exe -X POST http://127.0.0.1:8001/chat
-H "Content-Type: application/json" `
-d '{ "message": "How many gyro readings are in the database?" }'


______________________________________________________________________

## 端点

|方法|路径|目的|
|---|---|---|
| `GET` | `/health` |活体检查-退货 `{ "status": "ok" }` |
| `POST` | `/chat` |发送自然语言查询,返回结构化JSON操作|

### `/chat` 请求```json
{ "message": "What is the latest gyro Y value?" }

/chat 回应

代理始终返回以下操作类型之一(请参见
docs/LLM_USE_CASES.md 对于完整模式):```json
{
"reply": "{ \"action\": \"answer\", \"tts\": \"Gyro axis Y is 0.45 degrees per second, 2 seconds ago.\" }"
}


Android应用程序的 `LlmQueryHandler` 解析内部JSON并分派操作。

______________________________________________________________________

## 项目布局```
LLM_App/
├── app/
│   ├── main.py              # FastAPI entry point + lifespan that starts MCP + MQTT
│   ├── agent.py             # SensorAgent — provider-agnostic LLM orchestration
│   ├── database.py          # Direct SQLite access helpers (used outside MCP)
│   ├── logger.py            # Centralised rotating-file + console logger
│   └── providers/
│       ├── base.py          # Abstract LLMProvider interface
│       ├── anthropic.py     # Claude implementation
│       ├── openai.py        # GPT implementation
│       ├── deepseek.py      # DeepSeek implementation
│       ├── gemini.py        # Gemini implementation
│       └── __init__.py      # create_provider() factory
├── mcp_server/
│   ├── sensor_mcp_server.py # FastMCP server exposing 7 sensor tools
│   └── mqtt_subscriber.py   # Background MQTT → SQLite writer
├── config/
│   └── settings.py          # Settings class — reads from .env
├── docs/
│   └── LLM_USE_CASES.md     # Source of truth for what the LLM must handle
├── data/
│   └── sensor_database.db   # Server-side SQLite (created on first MQTT message)
├── logs/
│   └── biot.log             # Rotating log file (5 MB × 3)
├── .env                     # Real credentials (gitignored)
├── .env.example             # Safe template (committed)
├── pyproject.toml
└── README.md                # ← you are here

环境变量

看 .env.example 对于规范列表。关键问题:

变量 必填 默认 备注
LLM_PROVIDER 是的 anthropic 其中之一:人择、openai、deepseek、双子座
LLM_API_KEY yes -- 所选提供程序的密钥
LLM_MODEL 否 每个提供者默认值 例如。 claude-sonnet-4-6
SQLITE_DB_PATH 没有 data/sensor_database.db 服务器端数据库路径
SERVER_PORT 没有 8001 FastAPI端口
MCP_SERVER_PORT 没有 8002 MCP子进程端口
MQTT_BROKER_HOST 没有 127.0.0.1 蚊子宿主
MQTT_BROKER_PORT 没有 1883 莫斯基托港

切换LLM提供者

更改一行 .env:env LLM_PROVIDER=openai LLM_API_KEY=sk-...

无需更改代码。工厂在 app/providers/__init__.py 解决
启动时正确执行。每个提供者都实现相同的 LLMProvider
抽象类,因此代理代码永远不知道使用的是哪一个。

要添加新的提供者(例如Mistral):

  1. 创建 app/providers/mistral.py 子类化 LLMProvider.
  2. 添加 mistral 到 _SUPPORTED 在 app/providers/__init__.py.
  3. 在中添加导入+返回分支 create_provider().
  4. 在中添加默认模型 config/settings.py.

添加新的MCP工具

  1. 添加一个 @mcp.tool() 功能在 mcp_server/sensor_mcp_server.py.
  2. 添加相应 _TOOLS 进入 app/agent.py 所以法学硕士知道
    存在。
  3. 重新启动FastAPI服务器——MCP子进程随之重新启动。

该工具从以下位置调用 SensorAgent._dispatch_tool 通过HTTP,所以没有
SDK设置或注册模板超出了这两个文件。


故障排除

症状 可能原因 修复
MCP server unreachable at http://localhost:8002/mcp 在代理日志中 子进程在启动过程中崩溃 检查上面的终端输出是否有Python回溯——通常是缺少模块或端口冲突
Database file does not exist 从工具调用 MQTT订阅者尚未收到任何消息 确认Mosquitto正在运行,ESP8266正在发布,以及 MQTT_BROKER_HOST 匹配代理的IP
FastAPI启动,但 /chat 总是返回“代理未就绪” LLM_API_KEY 为空或无效 在中设置密钥 .env 并重新启动
日志显示代理呼叫 execute_query 重复使用奇怪的SQL 模型产生了列名幻觉 使用以下命令手动运行查询 sqlite3 要查看模式,请改进系统提示以明确提及列
端口8001正在使用 绑定到FastAPI端口的另一个进程 更改 SERVER_PORT 在 .env

BioT语音物联网——LLM_App | FHDW汉诺威物联网2025-26

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
BioT Speech IoT LLM App 怎么安装?

在客户端按下面的安装命令接入:uv run python -m app.main。装完在客户端配置里引用同一个包或端点。

BioT Speech IoT LLM App 怎么在 Claude 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

BioT Speech IoT LLM App 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

BioT Speech IoT LLM App 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

BioT Speech IoT LLM App 支持哪些客户端?

资料标注支持 Claude;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

BioT Speech IoT LLM App 能提供哪些能力?

资料显示约 1 个工具;能力标签包括 物联网、Python、Claude、LLM代理。具体工具清单以官方文档为准。

BioT Speech IoT LLM App 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

BioT Speech IoT LLM App 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。