AgentLayer MCP 服务器

一个通过 TypeScript + Hono 在 Cloudflare Workers 上运行的模型上下文协议 (MCP) 服务器，提供实时 AI 基础设施数据。

概述

AgentLayer MCP 服务器为 AI 智能体提供了 5 个端点：

Related MCP server: x402-api

功能特性

• 身份验证：所有端点均需 API 密钥验证

• 速率限制：可针对每个 API 密钥配置限制

• 使用日志：完整的请求/响应日志记录

• 错误处理：全面的错误处理，提供有意义的响应

• x402 微支付：原生支持 x402 支付协议

• Stripe 计费：订阅层级（入门版 $99/月，专业版 $299/月，规模版 $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 - 入门版的 Stripe 价格 ID

• STRIPE_PRO_MONTHLY_PRICE_ID - 专业版的 Stripe 价格 ID

• STRIPE_SCALE_MONTHLY_PRICE_ID - 规模版的 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 文档

身份验证

所有端点都需要通过 Header 或查询参数提供 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 提交

此服务器实现了用于 AI 智能体集成的模型上下文协议。提交至 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 Secrets：

• 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 问题跟踪器。