AgentLayer MCPサーバー

Cloudflare Workers上のTypeScript + Honoを使用して、リアルタイムのAIインフラデータを提供するModel Context Protocol (MCP) サーバーです。

概要

AgentLayer MCPサーバーは、AIエージェントが利用するための5つのエンドポイントを公開しています：

エンドポイント	説明
`/llm-costs`	プロバイダー全体のリアルタイムLLM価格データ
`/model-benchmarks`	モデルのパフォーマンスベンチマークと比較
`/api-deprecations`	非推奨のAPIバージョンと移行パスの追跡
`/quality-scores`	センチメント分析を含むAIモデルの品質スコア
`/agent-spend`	x402マイクロペイメント対応のエージェントAPI利用料追跡

特徴

認証: すべてのエンドポイントでAPIキー認証
レート制限: APIキーごとに設定可能な制限
利用ログ: 完全なリクエスト/レスポンスログ
エラーハンドリング: 有意義なレスポンスを伴う包括的なエラーハンドリング
x402マイクロペイメント: x402決済プロトコルのネイティブサポート
Stripe決済: サブスクリプション階層（Starter 月額99ドル、Pro 月額299ドル、Scale 月額499ドル）
センチメント分析: モデルのセンチメントスコアのためのReddit/HNの自動スクレイピング

技術スタック

ランタイム: Cloudflare Workers
フレームワーク: Hono (軽量、高速)
言語: TypeScript
データベース: Neon Postgres (サーバーレス)
決済: Stripe + x402プロトコル
データ取り込み: Firecrawl API

クイックスタート

前提条件

Node.js 20以上
Cloudflareアカウント
Neonデータベース
Stripeアカウント
Firecrawl APIキー

インストール

npm install

環境設定

.env.example を .env にコピーし、以下を設定します：

cp .env.example .env

必要な変数：

NEON_DATABASE_URL - Neon Postgres接続文字列
FIRECRAWL_API_KEY - Firecrawl APIキー
STRIPE_SECRET_KEY - Stripeシークレットキー
STRIPE_STARTER_PRICE_ID - Starter階層のStripe価格ID
STRIPE_PRO_MONTHLY_PRICE_ID - Pro階層のStripe価格ID
STRIPE_SCALE_MONTHLY_PRICE_ID - Scale階層のStripe価格ID

データベース設定

# 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

x402マイクロペイメント対応のエージェントAPI利用料を記録します。

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への提出

このサーバーは、AIエージェント統合のためのModel Context Protocolを実装しています。以下のようにMCP Hubに提出してください：

サーバー名: agentlayer-mcp-server
説明: リアルタイムAIインフラデータ（コスト、ベンチマーク、非推奨情報、品質スコア、利用料追跡）
トランスポート: APIキー認証付きHTTP
リポジトリ: 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

サポート

問題や機能リクエストについては、GitHubのissueトラッカーを使用してください。

AgentLayer MCP Server