TickerDB MCPサーバー

Name: TickerAPI
Author: tickerdb

TickerDB 用のMCP (Model Context Protocol) サーバー — AIエージェント向けの事前計算済み市場インテリジェンスを提供します。

TickerDBを、Claude Desktop、Claude Code、Cursor、Windsurf、OpenClaw、LangChain、LlamaIndex、AutoGen、CrewAIなど、MCP互換のあらゆるクライアントに接続できます。

利用可能なツール

ツール	説明
`get_summary`	単一ティッカーのテクニカルおよびファンダメンタルズ要約（日付範囲およびイベントフィルタリングをサポート）
`get_watchlist`	保存したウォッチリストティッカーのライブデータ
`get_watchlist_changes`	前回のパイプライン実行以降のフィールドレベルの差分
`add_to_watchlist`	ウォッチリストにティッカーを追加
`remove_from_watchlist`	ウォッチリストからティッカーを削除
`get_account`	アカウント詳細、プラン階層、および使用状況
`create_webhook`	ウォッチリスト変更用のWebhookを登録
`list_webhooks`	登録済みWebhookの一覧表示
`delete_webhook`	Webhookを削除

get_summary を start/end パラメータと共に使用して日付範囲全体のティッカーを一括同期したり、field/band パラメータを使用してイベントの発生状況をクエリしたりできます。

バンド安定性メタデータ

要約、ウォッチリスト、およびウォッチリスト変更ツールは、バンド安定性メタデータを返します。各バンドフィールド（トレンド方向、モメンタムゾーンなど）には、その状態がどの程度安定しているかを示す兄弟オブジェクト _meta が含まれます。安定性ラベルは fresh（新規）、holding（保持）、established（確立）、volatile（不安定）のいずれかです。完全なメタデータには、periods_in_current_state（現在の状態の継続期間）、flips_recent（直近の反転）、flips_lookback（過去の反転）も含まれます。このコンテキストは、エージェントが新しく入った状態と長期間継続している状態を区別するのに役立ち、取引シグナルやアラートの品質を向上させます。

セットアップ

オプション1: Claude.ai (OAuth)

mcp.tickerdb.com のリモートサーバーは、Claude.aiコネクタ用のOAuth 2.1をサポートしています。APIキーの管理は不要です。TickerDBアカウントでサインインすれば、残りはClaude.aiが処理します。

オプション2: リモートサーバー (Bearerトークン)

APIキーをBearerトークンとして使用し、任意のMCPクライアントを https://mcp.tickerdb.com/mcp に接続します。

オプション3: npmパッケージ (Claude Desktop, Cursorなど)

Claude Desktopの設定 (claude_desktop_config.json) に以下を追加します：

{
  "mcpServers": {
    "tickerdb": {
      "command": "npx",
      "args": ["tickerdb-mcp-server"],
      "env": {
        "TICKERDB_KEY": "tapi_your_api_key_here"
      }
    }
  }
}

APIキーは tickerdb.com/dashboard で取得してください。

構造

これは3つのパッケージからなるワークスペースです：

shared/ — 共有ツール定義、APIクライアント、サーバーファクトリ（内部用、公開なし）
remote/ — mcp.tickerdb.com にデプロイされたCloudflare Worker（ストリーミング可能なHTTPトランスポート + OAuth 2.1）
local/ — 公開されているnpmパッケージ tickerdb-mcp-server (stdioトランスポート)

リモートサーバーとnpmパッケージの両方が shared/ の同じツール定義を使用します。MCPサーバーは軽量なプロキシであり、階層ベースのアクセス制御、レート制限、フィールドフィルタリングはすべてTickerDB HTTP APIによって処理されます。

認証

リモートサーバーは2つの認証方法をサポートしています：

Bearerトークン — tapi_* APIキーを Authorization: Bearer tapi_... として直接渡します。
OAuth 2.1 — Claude.aiコネクタで使用されます。サーバーは動的クライアント登録、PKCE、トークン交換、および取り消しを実装しています。/authorize エンドポイントは、同意を得るためにメインのTickerDBサイトへリダイレクトします。

開発

# Install dependencies
npm install

# Build the remote worker
npm run build

# Dev server for remote worker
npx wrangler dev

# Build the npm package
cd local && npm install && npm run build

デプロイメント

リモートサーバー：

npx wrangler deploy

npmパッケージ：

cd local
npm version patch
npm run build
npm publish

TickerAPI