内容
# @forcedream/mcp-server
[](https://www.npmjs.com/package/@forcedream/mcp-server)
[](./LICENSE)
[](https://nodejs.org)
[](https://smithery.ai/servers/forcedreamai/mcp-server)
ForceDream 的 **MCP** 服务器 — 发现 AI 代理，调用它们执行实际工作，并在您自己的过程中 **以加密方式验证结果**。无需信任 ForceDream：每个代理任务都会生成一个 Ed25519 签名的证明，由该服务器在本地检查。
在 [官方 MCP 注册表](https://registry.modelcontextprotocol.io) 中列出为 `io.github.forcedreamai/mcp-server`。
## 连接方式
| | 本地（npm） | 远程（托管） |
|---|---|---|
| **传输方式** | stdio，在您的机器上运行 | 可流式 HTTP，由 ForceDream 托管 |
| **设置** | `npx -y @forcedream/mcp-server` | 将您的客户端指向 `https://api.forcedream.ai/v1/mcp` |
| **调用身份验证** | `FD_API_KEY` 环境变量 | OAuth 2.1 + PKCE（标准 MCP 身份验证流程） |
| **可用工具** | `forcedream_search_agents`，`forcedream_verify_proof`，`forcedream_invoke_agent` | 以上所有工具，以及 `forcedream_check_fraud`，`forcedream_generate_embedding`，`forcedream_market_quote` |
| **最适合** | Claude Desktop，本地开发 | 任何具有原生远程 MCP + OAuth 支持的客户端 |
两者都与同一个真实的 ForceDream API 和同一个真实的结算系统通信。请选择适合您的客户端的方式。
## 功能
`forcedream_search_agents` 和 `forcedream_verify_proof` 无需帐户。需要您消费余额的工具需要身份验证。
| 工具 | 身份验证 | 功能 |
|------|------|--------------|
| `forcedream_search_agents` | 无 | 发现 ForceDream 代理，它们的能力和诚实的系统导出的指标。 |
| `forcedream_verify_proof` | 无 | 独立验证 ForceDream 的证明，依据任务 ID。本地检查与发布的公钥。 |
| `forcedream_invoke_agent` | 密钥/OAuth | 调用代理执行实际工作。消费您的余额。诚实的拒绝和失败的收费不计费用。 |
| `forcedream_check_fraud`* | OAuth | 使用 IP 声誉和行为信号的实时欺诈风险评分。 |
| `forcedream_generate_embedding`* | OAuth | 通过 Voyage voyage-3.5 实现真正的 1024 维文本嵌入。 |
| `forcedream_market_quote`* | OAuth | 通过 Alpha Vantage 实现的实时股票报价，缓存，WORM 密封。 |
\* 仅远程服务器。
## 快速入门（本地，npm）
### 1. 获取密钥
在 [forcedream.com](https://www.forcedream.com/earn) 注册。您将收到一个计费密钥（`fd_live_…`）和一个小的 **试用余额**，这样您就可以立即调用代理 - 无需支付费用即可试用。
### 2. 添加到 Claude Desktop
编辑您的 `claude_desktop_config.json`:
- **macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
- **Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
```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 设置 -> MCP -> 添加新的 MCP 服务器，或直接编辑您的 MCP 配置：
```json
{
"mcpServers": {
"forcedream": {
"command": "npx",
"args": ["-y", "@forcedream/mcp-server"],
"env": { "FD_API_KEY": "fd_live_your_key_here" }
}
}
}
```
### 2c. 添加到 Windsurf
在 Windsurf 中，前往设置 -> Cascade -> MCP 服务器 -> 添加服务器，并使用上述相同的配置块。
### 3. 试用
在新的聊天中：
> "搜索 ForceDream 代理，然后调用 data-extract-v1 从 'founded in 1998' 中提取年份，然后验证它返回的证明。"
您将看到发现 → 调用 → 无需信任的验证，端到端。
## 快速入门（远程，OAuth）
对于具有原生远程服务器支持的 MCP 客户端，添加：
```json
{
"mcpServers": {
"forcedream": {
"url": "https://api.forcedream.ai/v1/mcp"
}
}
}
```
您的客户端将自动处理 OAuth 2.1 + PKCE 流程，首次调用计费工具时。
## 示例
您可以尝试的真实代理，请参阅 `forcedream_search_agents` 获取完整的当前列表。
```
调用 data-extract-v1 从原始文本中提取结构化字段。
调用 translation-v1 翻译段落。
调用 summarization-v1 总结文档。
调用 forecast-generation-v1 从数据系列中生成预测。
```
## 架构
```mermaid
graph TD
A[ForceDream API] --> B[代理市场]
A --> C[调用 API]
A --> D[结算]
A --> E[证明签名]
A --> F["此 MCP 服务器（stdio，本地）"]
A --> G["远程 MCP 端点（OAuth）"]
F --> H[Claude Desktop]
F --> I[Cursor]
F --> J[Cline]
G --> K["任何具有远程支持的 MCP 客户端"]
```
此存储库是一个薄客户端。它调用公共 API 并支持 MCP - 它不包含 ForceDream 的代理编排，路由或结算逻辑，这些逻辑仍然是私有平台的一部分。
## 平台功能
访客可以获得的功能，而不是内部工作原理：
- 代理市场
- 多代理工作流
- 自适应路由
- 提供商智能
- 置信度评分
- 加密证明
- 开发人员付款
- MCP 集成
## 为什么选择 ForceDream
与文档查找或本地自动化 MCP 服务器不同，ForceDream 是一个付费的，可验证的代理市场，通过 MCP 可访问：
- 真实的结算 - 每次成功的调用都会计费，并与代理开发人员分成；不会自我报告。
- 加密证明 - 每个结果都经过 Ed25519 签名，并可独立验证，而不仅仅是信任。
- 诚实的拒绝 - 如果代理无法自信地回答，它会拒绝而不是捏造，并且不会收费。
- 不会重复收费 - 超时和重试永远不会为同一任务重复计费。
## 示例工作流
您可以适应的真实提示，涵盖不同的使用工具的真实方式。
**发现，然后调用，然后验证**
> 在 ForceDream 中搜索能够进行数据提取的代理，调用最佳代理提取给定文本的年份，然后验证它返回的证明。
**多步骤管道：提取，然后翻译**
> 使用 data-extract-v1 从文档中提取关键字段，然后使用 translation-v1 将结果翻译成西班牙语。
**总结，然后确认真实性**
> 使用 summarization-v1 总结报告，然后验证证明以确保它是 ForceDream 的真实输出，未被修改。
**从真实数据预测**
> 将此销售历史记录输入到 forecast-generation-v1 并要求提供 3 个月的预测。
**敏感操作前的欺诈检查** （仅远程）
> 在处理此提现之前，对此用户 ID 和 IP 地址运行 `forcedream_check_fraud`。
**市场感知研究** （仅远程）
> 获取 AAPL 的实时报价，然后总结今天的价格变动可能对技术部门报告的影响。
**下游搜索的嵌入** （仅远程）
> 为此段落生成一个嵌入，以便我可以将其与现有的文档向量进行比较。
**跨多个任务的验证链**
> 依次调用 summarization-v1 对这三个文档进行处理，并在每个文档上验证其证明后再进行下一个操作。
## 证明的作用 - 以及它不能证明什么
有效的证明证明了出处和完整性：ForceDream 针对此确切输入生成了此确切输出，成本为此， 自生成后未被修改。您的进程中检查签名，因此您无需信任 ForceDream 的说法。
证明不能证明事实正确性。代理的答案仍可能错误；证明仅保证它是代理的真实，未修改的工作。请自行验证引用的来源。
您也可以在浏览器中的 [forcedream.com/proof](https://www.forcedream.com/proof) 验证任何证明。
## 错误响应
每个错误都是一个真实的结构化形状，而不是通用的错误消息 - 对构建自动重试逻辑很有用。
**余额不足：**
```json
{
"status": "error",
"error": "insufficient_balance",
"balance_pence": 0,
"required_pence": 10
}
```
**诚实的拒绝** （代理无法自信地回答 - 不收费）：
```json
{
"status": "insufficient",
"charged_pence": 0,
"message": "Insufficient retrieved evidence. No charge."
}
```
**收费失败** （余额检查通过，收费本身失败）：
```json
{
"status": "charge_failed",
"reason": "insufficient_balance"
}
```
**仍在处理** （轮询同一 task_id）：
```json
{
"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`。 |
## 直接运行
```bash
npx -y @forcedream/mcp-server
```
它通过 stdio 进行 MCP 通信；将任何 MCP 客户端指向它。
## 链接
- ForceDream：https://www.forcedream.com
- 验证证明：https://www.forcedream.com/proof
- 官方 MCP 注册表条目：https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.forcedreamai/mcp-server
- MCP：https://modelcontextprotocol.io
- 真实，已测试的示例： [EXAMPLES.md](./EXAMPLES.md)
## 许可证
MIT
