MCP-сервер AgentLayer

Сервер протокола контекста моделей (MCP), предоставляющий данные об ИИ-инфраструктуре в реальном времени с использованием TypeScript + Hono на Cloudflare Workers.

Обзор

MCP-сервер AgentLayer предоставляет 5 эндпоинтов для использования ИИ-агентами:

Функции

• Аутентификация: Аутентификация по API-ключу для всех эндпоинтов

• Ограничение частоты запросов (Rate Limiting): Настраиваемые лимиты для каждого API-ключа

• Логирование использования: Полное логирование запросов и ответов

• Обработка ошибок: Комплексная обработка ошибок с информативными ответами

• Микроплатежи x402: Встроенная поддержка платежного протокола x402

• Биллинг Stripe: Уровни подписки (Starter $99/мес, Pro $299/мес, Scale $499/мес)

• Анализ тональности: Автоматический сбор данных с Reddit/HN для получения оценок тональности моделей

Технологический стек

• Среда выполнения: Cloudflare Workers

• Фреймворк: Hono (легкий и быстрый)

• Язык: TypeScript

• База данных: Neon Postgres (serverless)

• Платежи: Stripe + протокол x402

• Сбор данных: Firecrawl API

Быстрый старт

Предварительные требования

• Node.js 20+

• Аккаунт Cloudflare

• База данных Neon

• Аккаунт Stripe

• API-ключ Firecrawl

Установка

npm install

Настройка окружения

Скопируйте .env.example в .env и настройте:

cp .env.example .env

Необходимые переменные:

• NEON_DATABASE_URL — строка подключения к Neon Postgres

• FIRECRAWL_API_KEY — API-ключ Firecrawl

• STRIPE_SECRET_KEY — секретный ключ Stripe

• STRIPE_STARTER_PRICE_ID — ID цены Stripe для уровня Starter

• STRIPE_PRO_MONTHLY_PRICE_ID — ID цены Stripe для уровня Pro

• STRIPE_SCALE_MONTHLY_PRICE_ID — ID цены Stripe для уровня Scale

Настройка базы данных

# Apply schema to Neon
npx tsx scripts/setup-neon-db.ts

# Verify tables created
npx tsx scripts/verify-db.ts

Разработка

npm run dev

Развертывание

npm run deploy

Документация API

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

Все эндпоинты требуют API-ключ через заголовок или параметр запроса:

X-API-Key: your-api-key
# or
?api_key=your-api-key

Эндпоинты

GET /llm-costs

Возвращает данные о ценах на LLM.

curl -H "X-API-Key: your-key" https://your-worker.workers.dev/llm-costs

GET /model-benchmarks

Возвращает результаты бенчмарков моделей.

curl -H "X-API-Key: your-key" https://your-worker.workers.dev/model-benchmarks

GET /api-deprecations

Возвращает устаревшие версии API.

curl -H "X-API-Key: your-key" https://your-worker.workers.dev/api-deprecations

GET/POST /quality-scores

Оценки качества с возможностью обновления данных о тональности.

# Get scores
curl -H "X-API-Key: your-key" https://your-worker.workers.dev/v1/quality-scores

# Trigger sentiment refresh
curl -H "X-API-Key: your-key" "https://your-worker.workers.dev/v1/quality-scores?refresh=true"

POST /agent-spend

Логирование расходов на API агента с поддержкой микроплатежей x402.

curl -X POST -H "X-API-Key: your-key" \
  -H "Content-Type: application/json" \
  -d '{"agent_id":"agent-123","model":"gpt-4","tokens_used":1500,"cost":0.045,"payment_receipt":"x402-receipt"}' \
  https://your-worker.workers.dev/agent-spend

GET /agent-spend

Получение записей о расходах агента.

curl -H "X-API-Key: your-key" "https://your-worker.workers.dev/agent-spend?agent_id=agent-123"

Отправка в MCP Hub

Этот сервер реализует протокол контекста моделей (MCP) для интеграции с ИИ-агентами. Отправьте в MCP Hub со следующими данными:

• Имя сервера: agentlayer-mcp-server

• Описание: Данные об ИИ-инфраструктуре в реальном времени (стоимость, бенчмарки, устаревшие API, оценки качества, отслеживание расходов)

• Транспорт: HTTP с аутентификацией по API-ключу

• Репозиторий: https://github.com/[org]/agentlayer-mcp-server

Архитектура

src/
├── index.ts                    # Main Hono app with all endpoints
├── routes/
│   └── v1-quality-scores.ts   # Quality scores route with sentiment refresh
└── scrapers/
    └── reddit-hn-sentiment.ts # Reddit/HN sentiment scraper via Firecrawl

CI/CD

Рабочий процесс GitHub Actions (.github/workflows/deploy.yml):

• Запускается при пуше в ветку main

• Проверяет типы с помощью TypeScript

• Развертывает в Cloudflare Workers

Необходимые секреты GitHub:

• CLOUDFLARE_API_TOKEN

• CLOUDFLARE_ACCOUNT_ID

• NEON_DATABASE_URL

• FIRECRAWL_API_KEY

• STRIPE_SECRET_KEY

• STRIPE_STARTER_PRICE_ID

• STRIPE_PRO_MONTHLY_PRICE_ID

• STRIPE_SCALE_MONTHLY_PRICE_ID

Лицензия

MIT

Поддержка

По вопросам и запросам на добавление функций используйте систему отслеживания проблем (issue tracker) на GitHub.