arcticdb MCP

arcticdb-mcp

An MCP server for structured read/write access to ArcticDB.

Overview • Demo • Quick Start • Configuration • Tools • Development

概述

arcticdb-mcp 回合 ArcticDB 成为AI数据复制品。助手可以自动化符号更新、批处理作业和时间序列查询，而内置的版本控制可以保护每一个更改。在几分钟内从问题到数据更改，而不是脚本，具有完全的可追溯性。您还可以在以下基础上设计自己的工作流程 arcticdb-mcp.

目录

• 演示视频
• 快速启动
• 安装
• 配置
• 运行模式
• 工具
• 示例提示
• 发展
• 社区待办事项列表
• 贡献
• 许可证

演示视频

观看直播 watch db 演示：

https://github.com/user-attachments/assets/dd81f229-e1f9-46e6-8e79-7c7252bc25c6

快速启动

1. 安装并运行 uvx （推荐）：

uvx arcticdb-mcp

1. 配置您的MCP客户端（克劳德桌面/光标/风帆/继续）：

{
  "mcpServers": {
    "arcticdb": {
      "command": "uvx",
      "args": ["arcticdb-mcp"],
      "env": {
        "ARCTICDB_URI": "lmdb:///path/to/your/database"
      }
    }
  }
}

1. 问你的助手：

• “给我看看图书馆财务中AAPL的最后5行”
• “在更新交易品种之前创建财务快照”
• “列出符号ES_intraday的版本”

安装

选择一个：

# Recommended
uvx arcticdb-mcp

# Or
pipx install arcticdb-mcp

# Or
pip install arcticdb-mcp

Python要求： >=3.9

配置

集 ARCTICDB_URI 在MCP客户端配置或环境中。

URI示例

• 本地LMDB（Linux/macOS）： lmdb:///path/to/db
• 本地LMDB（Windows）： lmdb://C:/path/to/db
• AWS S3： s3://s3.amazonaws.com:bucket?region=us-east-1&access=KEY&secret=SECRET
• Azure Blob： azure://AccountName=X;AccountKey=Y;Container=Z
• S3兼容（MinIO等）： s3://your-endpoint:bucket?access=KEY&secret=SECRET

您还可以使用 .env 文件：

ARCTICDB_URI=lmdb:///path/to/db

运行模式

stdio（默认）

这是桌面MCP客户端使用的默认模式。

ARCTICDB_URI=lmdb:///path/to/db python -m arcticdb_mcp

HTTP/SSE

集 ARCTICDB_MCP_PORT 要在HTTP/SSE上运行：

ARCTICDB_URI=lmdb:///path/to/db ARCTICDB_MCP_PORT=8000 python -m arcticdb_mcp

端点：

http://localhost:8000/sse

工具

当前服务器公开了48个工具。

北极与图书馆

符号

批量操作

快照

查询助手

维护

示例提示

• “阅读图书馆财务中的NVDA符号”
• “过滤价格>500且数量>=1000的NVDA”
• “将ES_intraday重新采样至5分钟，并计算总价平均值、体积总和”
• “将元数据所有者=研究写入符号ES_intraday”
• “删除2024年1月1日至2024年01月5日ES_intraday范围内的数据”

发展

git clone https://github.com/YMuskrat/arcticdb-mcp
cd arcticdb-mcp
pip install -e .

在本地运行：

ARCTICDB_URI=lmdb:///path/to/db python -m arcticdb_mcp

MCP检验员测试：

ARCTICDB_URI=lmdb:///tmp/test_db npx @modelcontextprotocol/inspector python -m arcticdb_mcp

社区待办事项列表

ArcticDB的这些功能有意对贡献者开放：

• stage
• finalize_staged_data
• sort_and_finalize_staged_data
• delete_staged_data
• get_staged_symbols
• read_batch_and_join
• admin_tools

贡献

看 贡献.md.

许可证

麻省理工学院