mcp-trmm

基本能力

产品定位

mcp-trmm 是一个用于增强与 RMM API 交互的工具集，特别适用于需要动态查询和转发 API 请求的场景。

核心功能

1. 解析 RMM API 架构：将 RMM API 的 YAML 或 JSON 架构解析并存储到 SQLite3 数据库中。
2. 查询数据库：通过关键字搜索 API 端点，获取路径、方法、描述、请求体和响应代码。
3. 转发请求：将查询到的 API 请求转发到实时生产 RMM API 服务器。
4. LLM 驱动的 CLI：通过大型语言模型（LLM）提供智能化的 CLI 界面，用于探索和查询 API 路径。
5. RAG 技术：利用 Retrieval-Augmented Generation (RAG) 技术，增强 API 查询的上下文感知能力。

适用场景

1. API 架构探索：动态查询和探索 RMM API 的可用路径和方法。
2. 实时 API 交互：将本地查询的 API 请求转发到实时生产环境。
3. 智能查询：通过 LLM 和 RAG 技术，实现更智能和上下文感知的 API 查询。

工具列表

1. 00_convert_yaml_json.py：将 YAML 文件转换为 JSON 格式。
2. 01_create_database.py：从 JSON 架构创建 SQLite3 数据库。
3. 02_query_database.py：通过关键字搜索数据库中的 API 端点。
4. 02_debug_relay2RMM.py：作为代理服务器，查询本地数据库并转发请求到实时 API。
5. 03_mcpserver.py：作为 MCP 代理服务器，转发请求到实时 RMM API。
6. 03_flaskapi.py：提供 API 端点，用于查询数据库和转发请求。
7. 03_llm_cli__rag.py：提供 LLM 驱动的 CLI 界面，用于智能查询 API 路径。

常见问题解答

1. 如何安装依赖？：使用 pip install fastapi uvicorn httpx mcpo sqlite3 pyyaml flask requests flasgger 安装所有依赖。
2. 如何启动服务？：分别运行 03_flaskapi.py、03_llm_cli__rag.py 和 03_mcpserver.py。
3. 如何查询 API 端点？：通过 CLI 或直接向 Flask API 发送 POST 请求。

使用教程

使用依赖

安装所有依赖：

pip install fastapi uvicorn httpx mcpo sqlite3 pyyaml flask requests flasgger

安装教程

1. 启动 Flask API 服务器：

source venv/bin/activate
python 03_flaskapi.py

1. 启动 LLM CLI 会话：

source venv/bin/activate
python 03_llm_cli__rag.py

1. 启动 MCP 代理服务器：

source venv/bin/activate
uvx mcpo --port 5086 -- uv run 03_mcpserver.py

调试方式

1. 查询 API 端点：

curl -X 'POST' \
  'http://127.0.0.1:5086/query' \
  -H 'Content-Type: application/json' \
  -d '{"query": "/agents", "api_key": "your_api_key"}'

1. 使用 CLI 查询：

python 03_llm_cli__rag.py

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。