Ambient MCP

环境mcp

英语| 日本语

这是一个 MCP（模型上下文协议）服务器 用于从以下位置检索数据 环境. 您可以致电 get_data 从MCP客户端获取时间范围内的最新值或数据的工具。

注意：此服务器使用环境API v2。

快速开始

该包尚未在PyPI上发布，因此请通过以下方式运行它 uvx 使用Git存储库。

uvx git+https://github.com/hrfmtzk/ambient-mcp

MCP客户端配置示例

以下是典型的MCP客户端配置。使用 uvx 作为命令并传递Git存储库 args.

{
  "mcpServers": {
    "ambient": {
      "command": "uvx",
      "args": ["git+https://github.com/hrfmtzk/ambient-mcp"]
    }
  }
}

先决条件

从Ambient准备以下信息：

• 通道ID
• 读取密钥

工具

get_data

使用以下方法之一获取环境项：

• 时间范围: from 和 to
• 最新项目: n 和 skip (skip 是可选的）

输入参数

您不能合并 from/to 和 n/skip.

示例：时间范围

{
  "read_key": "YOUR_READ_KEY",
  "channel_id": 12345,
  "from": "2024-01-01T00:00:00Z",
  "to": "2024-01-02T00:00:00Z"
}

示例：最新N个项目

{
  "read_key": "YOUR_READ_KEY",
  "channel_id": 12345,
  "n": 10,
  "skip": 0
}

输出

成功后，工具返回 field_labels 和 items.

{
  "field_labels": {
    "d1": "Temperature",
    "d2": "Humidity"
  },
  "items": [
    {
      "created": "2024-01-01T00:00:00Z",
      "d1": 23.4,
      "d2": 45.1
    }
  ]
}

错误

如果失败，工具将返回：

{
  "category": "validation",
  "message": "Human-readable error message"
}

可能的 category 值：

• validation
• forbidden
• not_found
• rate_limited
• upstream

______________________________________________________________________

开发者笔记

设置

uv sync

测试

uv run pytest

棉绒/格式

uv run ruff check src tests
uv run ruff format src tests
uv run mypy src tests