AgentLayer MCPサーバー

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

概要

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

Related MCP server: 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トラッカーを使用してください。