YMuskrat/arcticdb_mcp

arcticdb-mcp – ArcticDB への構造化アクセスのための MCP サーバー

それは何か – arcticdb-mcp は、オープンソースの時系列およびバージョン管理データストアである ArcticDB をラップする小さな Python ベースのサーバーです。データベースの機能を、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 ワークフローを可能にします。