YMuskrat/arcticdb_mcp

arcticdb-mcp – 用于结构化访问 ArcticDB 的 MCP 服务器

它是什么 – arcticdb-mcp 是一个基于 Python 的小型服务器，封装了 ArcticDB，一个开源的时序和版本化数据存储。它将数据库的功能暴露为一组 工具，可以从 MCP（模型上下文协议）客户端（如 Claude Desktop、Cursor、Windsurf 或 Continue）调用。实际上，这让对话式 AI 助手能够读取、写入、版本化和查询 ArcticDB 中的数据，而用户无需编写任何代码。

为什么重要 – 现代基于 LLM 的助手通常需要获取或更新大型版本化数据集（例如市场数据、传感器日志、实验结果）。arcticdb-mcp 提供了一个现成的、可追踪的 API，它：

• 支持按符号版本化和快照，以实现完全可审计性。
• 提供分页和服务器端切片，以便即使在 LLM 有限的令牌窗口内也能检查大型符号。
• 通过简单的 stdio（桌面 MCP 客户端的默认方式）或 HTTP/SSE 工作，使其易于嵌入本地脚本或远程服务。

关键能力（49 个工具）

• 库管理 – 列出、创建、删除库；检查选项。
• 符号操作 – 读取/写入/追加/更新/删除符号；获取头部/尾部；查询元数据；列出版本。
• 批量操作 – 在单个调用中对多个符号执行相同操作（例如 write_batch）。
• 快照 – 创建命名快照，列出/删除它们，并读取符号在快照时的状态。
• 查询辅助 – 过滤、isin、分组、日期范围和重采样操作，直接在 ArcticDB 中运行。
• 维护 – 重新加载/压缩符号列表，碎片整理数据，清理旧版本。
• 分页读取 – read_symbol_page 返回一行切片以及版本固定信息，支持一致的多页检索。

安装

# 推荐的一行命令
uvx arcticdb-mcp
# 替代方案
pipx install arcticdb-mcp
pip install arcticdb-mcp   # 需要 Python ≥3.9

运行

• StdIO（默认） – ARCTICDB_URI=lmdb:///path/to/db python -m arcticdb_mcp
• HTTP/SSE – 设置 ARCTICDB_MCP_PORT=8000（或任何 1-65535 的端口）并启动相同的命令；服务器将监听 http://localhost:8000/sse。

配置 – 唯一必需的设置是 ARCTICDB_URI，它可以指向：

• 本地 LMDB（lmdb:///path/to/db）
• AWS S3、Azure Blob 或任何兼容 S3 的端点（凭据在 URI 查询字符串中传递）
• 也可以使用 .env 文件。

典型对话提示

显示库 finance 中 AAPL 的最后 5 行
在更新符号之前创建 finance 的快照
列出符号 ES_intraday 的版本
过滤 NVDA 其中价格 > 500 且成交量 >= 1000
将 ES_intraday 重采样为 5 分钟并聚合价格均值、成交量总和

助手将这些自然语言请求转换为适当的工具调用，服务器返回数据（或确认），LLM 可以将其嵌入到回复中。

开发 – 克隆仓库，以可编辑模式安装（pip install -e .），并使用相同的 ARCTICDB_URI 环境变量在本地运行。提供了一个测试工具（@modelcontextprotocol/inspector）用于快速健全性检查。

路线图 – 该项目列出了一些开放的能力（例如分阶段数据处理、管理工具），贡献者可以实现。

许可证 – MIT。

---

底线 – arcticdb-mcp 是 ArcticDB 的高性能版本化数据存储与 LLM 驱动助手之间的实用桥梁，支持以数据为中心的 AI 工作流，具有完全可追踪性和最少的脚本编写。