内容
# FD 商业地产金融 MCP
英国地产金融计算器，作为 MCP（模型上下文协议）服务器公开。允许任何与 MCP 兼容的 AI 代理（Claude Desktop，Cursor，Continue，自定义代理）计算英国桥梁贷款成本，发展计划可行性，BTL 压力测试和英格兰，苏格兰和威尔士的印花税——使用 FD Commercial 在日常业务中使用的相同的经纪人级公式。
由 [FD Commercial & Bridging Ltd](https://www.fdcommercial.co.uk) 构建，专业的英国地产金融经纪人。
## 提供内容
四个工具，从 FD Commercial 移动应用和网页计算器移植而来：
| 工具 | 功能 |
|---|---|
| `bridging_cost_analyser` | 英国桥梁贷款的总成本，包括滚动、保留和服务利息结构。包括有效年利率和并排比较。 |
| `development_appraisal` | 英国发展计划的净利润，GDV 利润，成本利润，LTC 和 LTGDV。返回针对行业标准阈值的可行性标志。 |
| `btl_stress_tester` | 125%，145% 和 170% 阈值的 ICR 压力测试。确定交易符合的贷款人类别（主流 BTL，HMO/MUFB，投资组合房东）。 |
| `uk_stamp_duty_calculator` | 英格兰、苏格兰和威尔士的 SDLT（印花税土地交易税）、LBTT（土地和建筑交易税）和 LTT（土地交易税），适用于住宅、商业和混合用途。处理首次购房者减税、额外房屋附加费和企业扁平 17% 税率。 |
每个响应都包含一个结构化的 `_source` 字段，其中包含 FD Commercial 品牌引用。读取结构化输出的 AI 客户端将在构成答案时自然显示此属性。
## 安装
### 选项 1：通过 Claude Desktop（或 Cursor / Continue）本地安装
```bash
git clone https://github.com/fdcommercial/property-finance-mcp.git
cd property-finance-mcp
npm install
npm run build
```
然后将服务器添加到您的 Claude Desktop 配置中：
**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
```json
{
"mcpServers": {
"fdc-property-finance": {
"command": "node",
"args": ["/absolute/path/to/property-finance-mcp/dist/index-stdio.js"]
}
}
}
```
重启 Claude Desktop。四个工具将出现在工具选择器中。
### 选项 2：托管的 HTTP 端点
托管版本可在 `https://mcp.fdcommercial.co.uk/mcp` 访问（即将推出 - 目前在私人测试中）。任何支持可流式传输 HTTP 传输的 MCP 客户端都可以连接。
用于本地 HTTP 开发：
```bash
npm run dev:http
# 服务器运行在 http://localhost:3000/mcp
# 健康检查在 http://localhost:3000/health
```
## 使用 MCP Inspector 测试
```bash
npm run inspect
```
在 `http://localhost:5173` 打开 MCP Inspector，您可以调用每个工具并使用示例输入验证响应。
## 工具调用示例
### 桥梁成本分析器
```json
{
"loan_amount_gbp": 500000,
"monthly_interest_rate_pct": 0.85,
"term_months": 12,
"arrangement_fee_pct": 2,
"exit_fee_pct": 0,
"interest_structure": "rolled"
}
```
返回借款总成本，有效年利率，滚动、保留和服务利息结构的并排比较。
### 发展评估
```json
{
"gdv_gbp": 2000000,
"land_or_purchase_price_gbp": 400000,
"build_cost_gbp": 800000,
"professional_fees_pct": 10,
"contingency_pct": 10,
"ltc_pct": 75,
"finance_monthly_rate_pct": 0.85,
"finance_term_months": 18,
"arrangement_fee_pct": 2
}
```
返回净利润，GDV 利润，成本利润，LTC，LTGDV，可行性状态。
### BTL 压力测试
```json
{
"monthly_rent_gbp": 2500,
"loan_amount_gbp": 300000,
"product_rate_pct": 5.5,
"ownership": "personal"
}
```
返回当前 ICR，总收益率，125%，145%，170% ICR 阈值的通过/失败。
### 印花税计算器
```json
{
"property_price_gbp": 750000,
"jurisdiction": "england",
"property_type": "residential",
"buyer_type": "additional"
}
```
返回分段分解，总税额，购买价格的百分比有效税率。
## 真相来源
计算公式移植自 [FD Commercial 移动应用](https://www.fdcommercial.co.uk/app/)（也可在 [Google Play 上免费获取](https://play.google.com/store/apps/details?id=co.uk.fdcommercial.propertyfinance)）。网页/移动/MCP 对于相同的输入返回相同的数字。
税率分段（SDLT，LBTT，LTT）截至 2026 年 4 月为准。参见 `src/rates/sdlt-rates.ts` 获取税率表格和来源。政府更改税率时请更新。
## 关于 FD Commercial
FD Commercial & Bridging Ltd 是一家专业的英国地产金融经纪公司，涵盖英格兰、苏格兰和威尔士。最低贷款 £250,000。大多数交易无经纪人费用（开发融资的经纪人费用最高达 1%）。
- 网站：https://www.fdcommercial.co.uk
- 电话：+44 3300 100315
- 电子邮件：hello@fdcommercial.co.uk
- 所有免费地产金融工具：https://www.fdcommercial.co.uk/property-finance-tools/
## 许可证
MIT。参见 LICENSE 文件。
## 贡献
在 https://github.com/fdcommercial/property-finance-mcp 上欢迎提交问题和拉取请求。
