MCP-сервер TickerDB

Name: TickerAPI
Author: tickerdb

MCP-сервер (Model Context Protocol) для TickerDB — предварительно вычисленная рыночная аналитика для ИИ-агентов.

Подключает TickerDB к любому MCP-совместимому клиенту: Claude Desktop, Claude Code, Cursor, Windsurf, OpenClaw, LangChain, LlamaIndex, AutoGen, CrewAI и другим.

Доступные инструменты

Инструмент	Описание
`get_summary`	Техническая и фундаментальная сводка по одному тикеру (поддерживает фильтрацию по диапазону дат и событиям)
`get_watchlist`	Актуальные данные по тикерам из вашего списка отслеживания
`get_watchlist_changes`	Различия на уровне полей с момента последнего запуска конвейера
`add_to_watchlist`	Добавление тикеров в список отслеживания
`remove_from_watchlist`	Удаление тикеров из списка отслеживания
`get_account`	Информация об аккаунте, тарифном плане и использовании
`create_webhook`	Регистрация вебхука для изменений в списке отслеживания
`list_webhooks`	Список зарегистрированных вебхуков
`delete_webhook`	Удаление вебхука

Используйте get_summary с параметрами start/end для массовой синхронизации тикеров за определенный период или с параметрами field/band для запроса возникновения событий.

Метаданные стабильности полос (Band Stability)

Инструменты сводки, списка отслеживания и изменений списка отслеживания возвращают метаданные стабильности полос. Каждое поле полосы (направление тренда, зона импульса и т. д.) включает сопутствующий объект _meta, описывающий стабильность этого состояния. Метка стабильности может принимать одно из значений: fresh (новое), holding (удержание), established (установившееся) или volatile (волатильное). Полные метаданные также включают periods_in_current_state (периодов в текущем состоянии), flips_recent (недавние перевороты) и flips_lookback (история переворотов). Этот контекст помогает агентам различать недавно возникшее состояние и состояние, которое сохранялось в течение многих периодов, что повышает качество торговых сигналов и оповещений.

Настройка

Вариант 1: Claude.ai (OAuth)

Удаленный сервер по адресу mcp.tickerdb.com поддерживает OAuth 2.1 для коннекторов Claude.ai. Управление API-ключами не требуется — войдите в свою учетную запись TickerDB, а Claude.ai сделает все остальное.

Вариант 2: Удаленный сервер (Bearer-токен)

Подключите любой MCP-клиент к https://mcp.tickerdb.com/mcp, используя ваш API-ключ в качестве Bearer-токена.

Вариант 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.

Структура

Это рабочее пространство из трех пакетов:

shared/ — общие определения инструментов, API-клиент и фабрика сервера (внутренний, не публикуется)
remote/ — Cloudflare Worker, развернутый на mcp.tickerdb.com (потоковый HTTP-транспорт + OAuth 2.1)
local/ — опубликованный npm-пакет tickerdb-mcp-server (stdio-транспорт)

И удаленный сервер, и npm-пакет используют одни и те же определения инструментов из shared/. MCP-сервер является тонким прокси-сервером — весь контроль доступа на основе уровней, ограничение частоты запросов и фильтрация полей обрабатываются HTTP API TickerDB.

Аутентификация

Удаленный сервер поддерживает два метода аутентификации:

Bearer-токен — передавайте ваш API-ключ tapi_* напрямую как 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