Dealflowpro

DealFlowPro MCP 服务

可通过 Claude Code、Cursor、Claude Desktop 或任何兼容 MCP 的客户端分析多户型房地产交易。

DealFlowPro 是一个由 AI 驱动的多户型交易分析平台。此 MCP 服务封装了 DealFlowPro REST API，让 AI Agent 能够使用机构级的承销计算。

演示

可执行的操作

用自然语言向 Claude 提问，它会调用合适的工具：

• “分析这笔位于 Charlotte 的 24 个单元交易——要价 $2M，月租金 $13.6K，支出 $5.5K”
• “为这笔交易打分：12 个单元，$1.5M，月收入 $9K”
• “如果我希望现金回报率达到 8%，对于月租金 $28.8K 的房产，我最多应该出价多少？”
• “这处房产是否位于洪水区？2909 Burgess Dr, Charlotte, NC”

工具

工具	描述
analyze_deal	全面交易分析：资本化率、DSCR、现金回报率、IRR、DFP 评分（0-100）、最高出价和年度现金流
score_deal	快速筛选：DFP 评分 + 关键指标
reverse_calc	根据目标回报率（资本化率、CoC、DSCR、IRR）计算最高出价
market_data	查询任意地址的洪水区、社区收入与州中位数的对比，以及就业增长情况

这四个工具均带有 MCP 2025-06-18 注解（title、readOnlyHint、destructiveHint、idempotentHint、openWorldHint）。所有工具均为只读。

安装为 Claude 插件

此仓库也可作为 Claude Code / Cowork 插件使用。该插件连接到 https://dealflowpro.io/mcp 上的远程服务，而非上文的 npm 包，因此：

• 提供八个工具，而非四个。 新增 list_my_deals、get_deal_analysis、 get_my_criteria 和 portfolio_summary——可查看与账户关联的已保存交易、买入标准 和交易管线。
• 使用 OAuth，而非 API 密钥。 无需导出 DFP_API_KEY；插件连接时，只需登录 DealFlowPro 账户。

claude --plugin-dir /path/to/dealflowpro-mcp-server

如果需要本地 stdio 服务、倾向使用 API 密钥进行身份验证，或要将 DealFlowPro 接入非 Claude 的 MCP 客户端，请改用下方的 npm 包。

面向机构 AI 团队

DealFlowPro 旨在接入 AI 评估流水线和生产级 AI 技术栈。MCP 服务（本软件包，以及位于 https://dealflowpro.io/mcp 的远程端点）封装了与 REST API 相同的引擎——遵循严格的架构校验、具备幂等性且行为可预测。

身份验证与范围限定。 每次工具调用都会进行身份验证：使用 Bearer API 密钥，或在远程端点上通过 OAuth 登录。调用的范围限定为颁发密钥或登录的账户——不存在跨租户访问路径。每个工具的审计记录都会写入你账户的 logs/mcp_tool_calls.log，记录工具名称和扁平化后的参数键（不含参数值）——使用情况可审计，同时不会暴露交易内容。

各层级的速率限制。

层级	每日限额	每月	费用
Free	5 次请求，终身有效	—	免费，无需银行卡
Pay-as-you-go	按余额计	按积分计	$1/次请求
Essentials	50 次请求/天	~1,500	$79/月
Premium	200 次请求/天	~6,000	$149/月
Enterprise	1,000 次请求/天	~30,000	$399/月

每个响应都会返回速率限制标头（X-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Reset）。429 响应包含 Retry-After。

错误代码。 错误代码稳定，文档见 dealflowpro.io/api/docs/#errors——所有错误均采用 JSON {success: false, error: {code, message}} 格式。代码包括：invalid_input (400)、invalid_json (400)、unauthorized (401)、tier_required (403)、method_not_allowed (405)、payload_too_large (413)、rate_limit_exceeded (429)、internal_error (500)。

工具架构。 每个 MCP 工具都有经过严格架构校验的输入定义。向远程端点调用 tools/list，即可在运行时获取规范架构；REST OpenAPI 规范涵盖四个计算工具（analyze_deal、score_deal、reverse_calc、market_data）的相同数据结构。远程服务上的四个已保存工作流工具（list_my_deals、get_deal_analysis、get_my_criteria、portfolio_summary）仅支持 MCP，且需要 Essentials 或更高级别的套餐。

评估测试框架模式。 基准测试的推荐模式：维护一组（交易负载 → 预期指标）测试数据，对每组数据调用 score_deal（这是最轻量的工具；每次调用仍计为一次请求，因此请按上方层级表规划用量），并断言指标处于容差范围内。该端点具有确定性——相同输入会产生相同输出。

数据处理。 请求负载在内存中处理，不会持久化到磁盘。传输过程中使用 TLS 1.2+。Anthropic API 调用（DealFlowPro 在内部使用 Claude 提取文档时）通过 DealFlowPro 的零数据保留 Anthropic 工作区进行。完整说明见：dealflowpro.io/security#api-mcp-data-handling。

设置

有两种安装方式——请选择与客户端相匹配的方式。

路径 A — 远程 MCP URL（无需本地安装）

适用于 claude.ai 网页版（自定义连接器）、使用 HTTP 传输的 Claude Code 或 Claude API mcp_servers。端点为 https://dealflowpro.io/mcp（Streamable HTTP，MCP 2025-06-18）。

claude.ai 网页版 / Claude Desktop： DealFlowPro 已列入 Claude 连接器目录，你可以直接添加，也可以将其添加为自定义连接器 — 前往 Customize → Connectors → “Add custom connector” → 将名称设为 DealFlowPro，粘贴 https://dealflowpro.io/mcp → Add → Connect → 登录 DealFlowPro → 点击 Allow。OAuth 会自动处理身份验证（无需管理 API 密钥）。然后在聊天中点击 “+” → Connectors → 开启 DealFlowPro。

将 DealFlowPro 添加到 Claude → — 打开对话框，并预先填入名称和 URL。添加前仍需由你检查并确认。

Team / Enterprise 套餐： 成员无法自行添加自定义连接器。组织所有者需前往 Organization settings → Connectors → Add → Custom（类型：Web）添加一次，然后每位成员再从 Customize → Connectors 连接自己的 DealFlowPro 账户。

Claude Code（HTTP）：

claude mcp add dealflowpro \
  --transport http \
  --url https://dealflowpro.io/mcp \
  --header "Authorization: Bearer dfp_sk_your_key_here"

Claude API：

POST https://api.anthropic.com/v1/messages
anthropic-beta: mcp-client-2025-11-20

{
  "mcp_servers": [{
    "type": "url",
    "url": "https://dealflowpro.io/mcp",
    "name": "dealflowpro",
    "authorization_token": "dfp_sk_your_key_here"
  }],
  ...
}

在 dealflowpro.io/api 获取 Bearer 密钥（免费 5 次请求密钥，无需银行卡；也可购买按量付费额度）。

完整设置详情和已连接应用的撤销方法：dealflowpro.io/api/docs#mcp。

路径 B — 本地 stdio（此 npm 包）

如果你希望 MCP 服务在本地运行而非远程运行，或使用不支持自行配置远程 URL 的客户端，请使用此方式。Claude Desktop 两种方式均支持：通过 Settings → Connectors 连接远程服务，或使用下方的本地配置。

1. 获取 API 密钥。 访问 dealflowpro.io/api 领取免费 5 次请求密钥（无需银行卡）或购买按量付费额度。密钥将通过电子邮件发送。

2. 添加到客户端。

Claude Desktop — claude_desktop_config.json：

{
  "mcpServers": {
    "dealflowpro": {
      "command": "npx",
      "args": ["-y", "dealflowpro-mcp"],
      "env": {
        "DFP_API_KEY": "dfp_sk_your_key_here"
      }
    }
  }
}

Claude Code：

claude mcp add dealflowpro -e DFP_API_KEY=dfp_sk_your_key_here -- npx -y dealflowpro-mcp

使用方法

只需向 Claude 询问有关交易的问题。它会自动选择合适的工具。

示例输出

## Deal Analysis Results

**DFP Score: 19/100 (Poor)**

### Key Metrics
| Metric | Value |
|--------|-------|
| Cap Rate | 4.48% |
| DSCR | 0.86 |
| Cash-on-Cash | -1.95% |
| IRR | -12.17% |
| NOI | $89,524 |

### Max Offer Price
**$1,197,476** (binding constraint: cash-on-cash)

API 文档

完整的 REST API 文档请访问 dealflowpro.io/api/docs

定价

• 按量付费： 每次 API 请求 $1，最低 $5 起
• Essentials： 每天包含 50 次 API 请求（$79/月）
• Premium： 每天 200 次请求 + 反向计算器（$149/月）
• Enterprise： 每天 1,000 次请求（$399/月）

要求

• Node.js 18+
• DealFlowPro API 密钥

关于 DealFlowPro

DealFlowPro 可为 2-200 单元的房产自动执行多户住宅投资分析。上传经纪人电子邮件或 OM，即可在 10 分钟内获得完整的投资分析，而非耗时 2 小时。运营商、辛迪加机构和 PE 公司均使用它来更快地筛选交易。

dealflowpro.io

许可证

MIT