Verity Skills

Verity MCP 服务

面向 Verity 技能的公开 MCP（模型上下文协议）服务。提供六个可调用的端点，供 AI Agent 在任何交易前调用：检测协同行为、评估市场主题、交叉核查声明、标记虚假信息模式。

生产环境端点： https://mcp.verityskills.com/mcp

为什么选择 Verity 技能

ApeWisdom 有仪表板。StockTwits 有信息流。Verity 有技能。它能在交易前进行完整性检查，而大多数 AI 工作流都缺少这一环。只需连接一次，Verity 的每项功能都会成为可在 Claude、Cursor、LangChain 或 LlamaIndex 工作流中调用的函数。

每项技能都需要 Verity API 密钥。几秒钟即可在 https://verityskills.com/account/api-keys 生成密钥。

安装

Claude Desktop

将配置添加到 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）或 %APPDATA%\Claude\claude_desktop_config.json（Windows）。使用原生 HTTP 传输（Claude Desktop 2026 版本）：

{
  "mcpServers": {
    "verity": {
      "type": "http",
      "url": "https://mcp.verityskills.com/mcp",
      "headers": {
        "Authorization": "Bearer vtk_<your-token>"
      }
    }
  }
}

如果你的 Claude Desktop 版本较旧，且不接受 type: "http"，请使用 mcp-remote stdio 桥接。完整指南请参阅 docs/CLAUDE_DESKTOP.md。重新启动前，请完全退出 Claude Desktop（macOS 上按 Cmd-Q）。

Cursor

将配置添加到 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "verity": {
      "url": "https://mcp.verityskills.com/mcp",
      "headers": {
        "Authorization": "Bearer vtk_<your-token>"
      }
    }
  }
}

重启 Cursor。完整指南请参阅 docs/CURSOR.md。

直接调用 API（curl，无需 MCP 客户端）

curl -sS -X POST https://mcp.verityskills.com/mcp \
  -H 'content-type: application/json' \
  -H 'Authorization: Bearer vtk_your_key_here' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "coordination-heat",
      "arguments": { "subject": "GME" }
    }
  }'

全部六项技能都需要在 https://verityskills.com/account/api-keys 生成的 API 密钥。

其他 Agent 运行时

任何兼容 MCP 的 Agent 运行时均可使用。端点通过 HTTP+SSE 提供服务，地址为 https://mcp.verityskills.com/mcp（SSE 通道将在未来添加；目前可使用 HTTP POST）。每次调用技能时都要添加 Authorization: Bearer vtk_<token>。

可用技能

技能	认证	功能
coordination-heat	必需	评估主题、股票代码或叙事中的协同行为。
verity-score	必需	计算市场主体的综合完整性评分。
morning-brief	必需	汇总关注列表中的隔夜信号，生成每日简报。
verity-scan	必需	实时扫描主题、股票代码或声明。
cross-check-alert	必需	根据受监控来源交叉核查声明。
disinfo-alert	必需	监控主题或股票代码中的虚假信息模式。

市场平台列表

• Smithery.ai（待审核）
• Cursor Directory（待审核）
• PulseMCP、Glama、MCP.so（待审核）

架构

部署在 Cloudflare Workers 上的轻量级 Bearer 令牌代理。无状态，不需要数据库凭据。

• 将 MCP 客户端发来的 Authorization: Bearer vtk_* 转换为上游 verityskills.com 技能路由所需的 x-verity-key 标头。
• 按照 MCP 规范（2025-03-26）使用 JSON-RPC 2.0 封装。
• 将 402 TRIAL_CAP_REACHED 响应改写为包含绝对 upgrade_url 的响应，以便 MCP 客户端将试用额度用尽的用户引导至正确的升级页面。
• 将上游 5xx 响应封装为 JSON-RPC -32603 信封，并返回 HTTP 200，以确保传输层重试语义正确。
• 通过 Wrangler 密钥 MCP_TOOLS_DISABLED 按工具禁用功能。通过 MCP_KILL_SWITCH=on 全局禁用。
• 使用 @sentry/cloudflare 进行 Sentry 监控。通过 beforeSend 钩子，从所有已捕获事件中清除 Bearer 令牌。

运维

事项	来源
部署、密钥和 DNS	docs/DEPLOY_RUNBOOK.md
部署后冒烟测试	scripts/post-deploy-smoke.sh <base-url>
合成监控	cchurctrip/verity:app/api/cron/mcp-synthetic-smoke/route.ts 中的 5 分钟定时任务
健康检查端点	GET https://mcp.verityskills.com/health
市场平台提交	docs/SMITHERY.md、docs/CURSOR.md

开发

git clone https://github.com/cchurctrip/verity-mcp
cd verity-mcp
npm install
npm test            # 237 unit + property + integration tests
npm run lint
npm run typecheck
npm run check-manifest
npx wrangler dev    # local worker on http://localhost:8787

许可证

MIT。请参阅 LICENSE。