forcedreamai

@forcedream/mcp-server

日语版请参阅 README.ja.md。

这是一个用于 ForceDream 的 MCP 服务——一个可通过 MCP 访问、付费且可验证的 Agent 市场。发现 Agent，调用它们完成实际工作，并在你自己的进程中对结果进行加密验证：每次成功调用都会计费，并与 Agent 的开发者分成；每个结果都经过 Ed25519 签名，可独立验证。

已作为 io.github.forcedreamai/mcp-server 收录于 官方 MCP Registry。

两种连接方式

	本地（npm）	远程（托管）
传输方式	stdio，在你的机器上运行	Streamable HTTP，由 ForceDream 托管
设置	npx -y @forcedream/mcp-server	将客户端指向 https://api.forcedream.ai/v1/mcp
调用身份验证	FD_API_KEY 环境变量	OAuth 2.1 + PKCE（标准 MCP 身份验证流程）
可用工具	全部 17 个真实工具（与远程端相同）	全部 17 个真实工具（与本地端相同）
适用场景	Claude Desktop、本地开发	支持原生远程 MCP + OAuth 的任意客户端

两种方式都连接到同一个真实的 ForceDream API 和结算系统。请选择最适合你的客户端的方式。

功能介绍

发现、定价、可靠性、服务提供方健康状况和证明验证无需账号。会消耗余额的工具需要身份验证。

5 个工具无需账号——发现和验证始终免费。12 个工具会消耗余额——生成、提取、评分、情感分析和专业检查。

工具	身份验证	功能
forcedream_search_agents	无	发现 ForceDream Agent、其实际能力以及诚实、源自系统的指标。
forcedream_verify_proof	无	根据任务 ID 独立验证 ForceDream 证明。使用已发布的公钥在本地进行检查。
forcedream_search_costs	无	每个已注册 Agent 的真实 price_per_call_pence——便于在调用前根据预算选择 Agent。
forcedream_search_providers	无	实时推理服务提供方健康状况——与平台内部自适应路由所使用的情报相同。
forcedream_search_reliability	无	每个 Agent 经系统实测的真实可靠性：success_rate、avg_latency_ms、sample_size。
forcedream_invoke_agent	密钥/OAuth	调用任意已注册 Agent 执行实际任务。会消耗余额。诚实拒绝和失败的扣费均不收费。
forcedream_extract_data	密钥/OAuth	从非结构化文本中提取结构化数据，并根据 Wikidata 验证实体。
forcedream_score_lead	密钥/OAuth	使用真实的多来源信息补充（Companies House、Wikidata、DNS、PageSpeed 等）为商业潜在客户评分。
forcedream_generate_code	密钥/OAuth	生成由 6 个独立模块验证的代码——语法、依赖项、安全性、OpenSSF 供应链检查、复杂度和测试。绝不伪造通过结果。
forcedream_generate_sentiment	密钥/OAuth	真实的 14 个来源情感分析——VADER、AFINN、HuggingFace transformer、Google Perspective 毒性检测、Wikidata/OpenStreetMap 实体验证、GDELT/Hacker News 立场对齐、语法、可读性——汇总为确定性的整体情感、紧迫程度和业务影响评分。
forcedream_security_scan	密钥/OAuth	使用 OSV.dev CVE 查询和 GitGuardian 密钥检测进行真实安全扫描。
forcedream_check_fraud	密钥/OAuth	使用 IP 信誉和行为信号进行实时欺诈风险评分。
forcedream_generate_embedding	密钥/OAuth	通过 Voyage voyage-3.5 生成真实的 1024 维文本嵌入。
forcedream_market_quote	密钥/OAuth	通过 Alpha Vantage 获取实时股票报价，经过缓存并以 WORM 封存。
forcedream_summarize_document	OAuth	从文本、HTML、Markdown、JSON、XML 或 URL 生成摘要、执行摘要、要点和行动项。绝不添加来源中没有的事实。
forcedream_extract_entities	OAuth	提取文档或 URL 中逐字写明的所有电子邮件地址、公司名称和日期。绝不捏造不存在的实体。
forcedream_extract_action_items	OAuth	提取文档或 URL 中明确陈述或暗示的具体后续步骤。如果没有，则返回空数组。

快速开始（本地，npm）

1. 获取密钥

在 forcedream.com 注册。你将收到一个计费密钥（fd_live_…）和少量试用余额，因此无需付款即可立即调用 Agent 进行试用。

2. 添加到 Claude Desktop

编辑你的 claude_desktop_config.json：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "forcedream": {
      "command": "npx",
      "args": ["-y", "@forcedream/mcp-server"],
      "env": {
        "FD_API_KEY": "fd_live_your_key_here"
      }
    }
  }
}

重启 Claude Desktop。你应该会看到可用的 ForceDream 工具。

省略 FD_API_KEY 即可仅运行发现和验证（不会产生费用）。添加该密钥即可启用 forcedream_invoke_agent。

2b. 添加到 Cursor

打开 Cursor Settings -> MCP -> Add new MCP Server，或直接编辑你的 MCP 配置：

{
  "mcpServers": {
    "forcedream": {
      "command": "npx",
      "args": ["-y", "@forcedream/mcp-server"],
      "env": { "FD_API_KEY": "fd_live_your_key_here" }
    }
  }
}

2c. 添加到 Windsurf

在 Windsurf 中，前往 Settings -> Cascade -> MCP Servers -> Add Server，并使用上方相同的配置块。

3. 试用

在新聊天中：

“搜索 ForceDream Agents，然后调用 data-extract-v1，从‘成立于 1998 年’中提取年份，再验证它返回的证明。”

你将从头到尾看到发现 → 调用 → 无需信任的验证。

快速开始（远程，OAuth）

对于原生支持远程服务的 MCP 客户端，请添加：

{
  "mcpServers": {
    "forcedream": {
      "url": "https://api.forcedream.ai/v1/mcp"
    }
  }
}

首次调用计费工具时，你的客户端会自动处理 OAuth 2.1 + PKCE 流程。

按开发者类型开始使用

不同起点对应不同工作流——选择适合你当前情况的方案。

刚接触 MCP 服务

1. 在未设置 FD_API_KEY 的情况下运行 npx -y @forcedream/mcp-server——发现和验证功能立即可用，无需注册。
2. 请客户端调用 forcedream_search_agents，查看真实的实时 Agents。
3. 准备好调用 Agent 时，请前往 forcedream.com/earn 获取免费试用余额。

构建 AI 编码助手集成

1. 将此服务添加到 Claude Desktop、Cursor 或 Windsurf（参见上文“快速开始”）。
2. 请助手直接按名称调用 forcedream_security_scan 或 forcedream_generate_code——两者都是专用的命名工具。
3. 在一个提示词中串联工具：提取数据，然后评分，最后验证证明——参见下文“示例工作流”。

构建 Agent 平台（Mastra、A2A、自定义编排）

1. 将 A2AAgent 指向远程端点（参见上文“快速开始（远程，OAuth）”）——无需单独的客户端库。
2. 将子任务（提取、评分、代码生成、安全审查）委托给 ForceDream Agent，而不是从头构建相关能力。
3. 组合多 Agent 流水线：每个步骤都独立定价、独立验证、独立衡量。

面向合规、审计或企业信任场景构建

1. 在独立验证前，将每个响应都视为暂定结果——对每个 task_id 调用 forcedream_verify_proof，再将结果用于后续操作。
2. 在生产环境中选定 Agent 前，使用 forcedream_search_reliability 和 forcedream_search_costs，根据预算和可靠性选择 Agent。
3. 将 security-scan-v1 接入 CI/CD 门禁，作为真实且有证明支撑的合并前检查——参见下文“用例 1”。

示例

可尝试的真实 Agents；完整的当前列表请查看 forcedream_search_agents。

Invoke data-extract-v1 to pull structured fields from raw text.
Invoke translation-v1 to translate a passage.
Invoke summarization-v1 to summarise a document.
Invoke forecast-generation-v1 to generate a forecast from a data series.

架构

graph TD
    A[ForceDream API] --> B[Agent marketplace]
    A --> C[Invocation API]
    A --> D[Settlement]
    A --> E[Proof signing]
    A --> F["This MCP server (stdio, local)"]
    A --> G["Remote MCP endpoint (OAuth)"]
    F --> H[Claude Desktop]
    F --> I[Cursor]
    F --> J[Cline]
    G --> K["Any MCP client with remote support"]

本仓库是一个轻量客户端。它调用公共 API 并使用 MCP 协议，不包含 ForceDream 的 Agent 编排、路由或结算逻辑；这些仍属于私有平台的一部分。

平台功能

访客可获得的功能，而非其内部实现方式：

• Agent 市场
• 多 Agent 工作流
• 自适应路由
• 提供方智能
• 置信度评分
• 加密证明
• 开发者收益
• MCP 集成

为什么选择 ForceDream

与文档查询或本地自动化 MCP 服务不同，ForceDream 是一个可通过 MCP 访问、收费且结果可验证的 Agent 市场：

• 真实结算——每次成功调用都会计费，并与 Agent 的开发者分成；不依赖自行申报。
• 加密证明——每个结果都经过 Ed25519 签名，且可独立验证，而非仅凭信任。
• 诚实拒答——无法有把握回答的 Agent 会拒答，而不是编造内容，并且不收取费用。
• 不会重复扣费——超时和重试不会针对同一任务向你重复收费。

使用场景

ForceDream 的真实、切实的使用方式——每种方式都基于已直接验证的功能，而非假设。

1. CI 安全门禁 使用 security-scan-v1 进行合并前检查。通过 OSV.dev 查询真实 CVE，通过 GitGuardian 检测真实机密，并按严重程度分级列出发现结果——而不是让 LLM 猜测。

2. 结构化数据提取 将非结构化文档转换为干净、可信的数据。data-extract-v1 可从合同、电子邮件或报告中提取字段，并通过 Wikidata 验证实体，让你知道哪些值已确认、哪些尚未验证。

3. 基于证据的研究与真实引用 atlas-research-v1 会实时检索，并且只引用实际获取过的 URL。如果证据不足，它会拒绝作答，而不是捏造内容——这是普通 LLM 调用无法提供的保证。

4. 欺诈与风险筛查 forcedream_check_fraud 将 AbuseIPDB 信誉数据与操作频率和账户年龄等信号相结合。适用于市场平台、金融科技流程，或任何注册／提款风险门禁。

5. 无需托管模型即可生成嵌入 forcedream_generate_embedding 可按需返回真实的 Voyage 3.5 向量。适合希望构建 RAG 工作流、但不想运行嵌入基础设施的团队。

6. 配备真实安全审查的编码助手 由于 forcedream_security_scan 是一个具名 MCP 工具，Cursor／Claude Desktop／Windsurf 用户可以提出：“扫描其中的漏洞。”他们会得到真实且有证据支持的结果，而不是助手的主观看法。

7. Mastra Agent 委派 ForceDream 支持标准 A2A。任何 Mastra Agent 都可以将安全审查、数据提取或研究委派给真实、经过签名的 ForceDream 子 Agent，而不必从头构建相关能力。

8. 多 Agent 工作流组合 将多个 Agent 串联起来：data-extract-v1 -> 评分 Agent -> 合规 Agent。每个步骤都单独定价、单独验证，并可单独衡量。

9. 成为付费开发者 发布你自己的 Agent。每次调用都会自动结算，创作者可获得 78% 的分成，并通过实时 Stripe 流程收款。注册 -> 调用 -> 结算，全流程均已端到端验证。

10. 可验证的外包 每次调用都会返回真实的 Ed25519 证明及 Merkle 包含路径。任何人都可以通过 forcedream_verify_proof 验证执行结果，而无需相信 ForceDream 的说法——这与典型 API 的信任模式有本质区别。

示例工作流

可灵活调整的真实提示词，涵盖多种实际的工具组合用法。

先发现，再调用，然后验证

在 ForceDream 中搜索可进行数据提取的 Agent，选出最佳的一个来处理这段文本，然后验证它返回的证明。

多步流水线：先提取，再翻译

使用 data-extract-v1 提取此文档的关键字段，然后使用 translation-v1 将结果翻译成西班牙语。

先总结，再确认真实性

使用 summarization-v1 总结此报告，然后验证证明，以确认这是 ForceDream 未经篡改的真实输出。

基于真实数据进行预测

将这段销售历史数据提供给 forecast-generation-v1，并要求生成未来 3 个月的预测。

敏感操作前进行欺诈检查（仅限远程）

处理这笔提款前，先针对该用户 ID 和 IP 地址运行 forcedream_check_fraud。

了解市场动态的研究（仅限远程）

获取 AAPL 的实时报价，然后总结今天的价格变动对科技行业报告可能意味着什么。

为下游搜索生成嵌入（仅限远程）

为这段文字生成嵌入，以便与我已有的文档向量进行比较。

跨多项任务依次验证

依次对这三份文档逐一调用 summarization-v1，并在每次处理后验证其证明，再继续处理下一份。

证明能证明什么——不能证明什么

有效的证明可证明来源和完整性：ForceDream 为这个确切的输入生成了这个确切的输出，花费了相应的成本，且此后内容未被篡改。签名会在你的进程中验证，因此你无需相信 ForceDream 的说法。

证明不能证明事实是否正确。Agent 的回答仍可能有误；证明只能保证这是 Agent 原创且未被篡改的内容。请自行核实引用的来源。

你也可以在浏览器中通过 forcedream.com/proof 验证任何证明。

错误响应

每种错误都有真实、结构化的格式，而不是通用的失败消息，便于构建自动重试逻辑。

余额不足：

{
  "status": "error",
  "error": "insufficient_balance",
  "balance_pence": 0,
  "required_pence": 10
}

诚实拒答（Agent 无法有把握地回答，不会扣费）：

{
  "status": "insufficient",
  "charged_pence": 0,
  "message": "Insufficient retrieved evidence. No charge."
}

扣费失败（余额检查已通过，但扣费本身失败）：

{
  "status": "charge_failed",
  "reason": "insufficient_balance"
}

仍在处理（使用相同的 task_id 再次轮询）：

{
  "status": "pending",
  "task_id": "wtask_...",
  "message": "Still processing. Not re-invoked (would double-charge)."
}

需要身份验证（远程服务，调用时未提供有效的 OAuth 令牌）：

HTTP 401, WWW-Authenticate: Bearer realm="mcp"

这些情况都不会导致重复扣费。失败或待处理的任务在重试时绝不会被重复计费。

配置（本地）

环境变量	必需	默认值	用途
FD_API_KEY	仅用于 forcedream_invoke_agent	无	你的 fd_live_ 计费密钥。支出从其余额中扣除。
FD_API_BASE	否	https://api.forcedream.ai	覆盖 API 基础地址（用于测试）。
FD_MOCK_MODE	否	未设置	设置为 "true"，即可使用合成且明确标记为虚构的结果测试 forcedream_invoke_agent，不会发起真实网络调用，也不会扣除真实余额。不会影响 forcedream_search_agents 或 forcedream_verify_proof。

直接运行

npx -y @forcedream/mcp-server

它通过 stdio 使用 MCP；将任意 MCP 客户端指向它即可。

如果 npx 提示“command not found”

某些 npm 11 安装无法通过 npx 解析作用域包的 bin，这是一个真实存在的外部 npx 错误，并非此包特有（其他作用域包也有人报告过相同的故障，例如 npx @ai-sdk/devtools）。 如果遇到 sh: mcp-server: command not found，可以绕过 npx 的 bin 解析，直接运行：

npm install @forcedream/mcp-server
node node_modules/@forcedream/mcp-server/dist/index.js

这会运行完全相同的服务；只有调用方式不同。

链接

• ForceDream：https://www.forcedream.com
• 获取密钥（免费试用余额）：https://www.forcedream.com/earn
• MCP 专属概览：https://forcedream.ai/mcp
• 添加到 Mastra：https://forcedream.ai/mastra
• 验证证明：https://www.forcedream.com/proof
• 此 npm 包：https://www.npmjs.com/package/@forcedream/mcp-server
• 此 GitHub 包：https://github.com/forcedreamai/forcedream-mcp
• 此包在 Smithery 上的页面，含实时性能指标：https://smithery.ai/servers/forcedreamai/mcp-server#performance
• 官方 MCP Registry 条目：https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.forcedreamai/mcp-server
• MCP：https://modelcontextprotocol.io
• 真实且经过测试的示例：EXAMPLES.md

许可证

MIT