使用说明

跟进Boss MCP服务器

一个强大的模型上下文协议（MCP）服务器，用于与 跟进老板 房地产CRM API。这个基于Python的MCP服务器使AI助手能够智能地与您的 跟进老板 数据，提供对联系人、潜在客户、交易等的全面访问。

🚀 生产就绪：完整的CRUD操作、智能缓存、重复检测和自动分页 跟进老板 CRM数据。

什么是跟进老板？

跟进老板 是一个领先的房地产CRM平台，帮助代理商和团队管理他们的潜在客户、联系人和交易。此MCP服务器提供对您的 跟进老板 帐户，允许AI助手高效地查询、分析和管理您的CRM数据。

主要特点

🎯 完成跟进Boss集成

34 MCP工具 为了全面 跟进老板 API访问
完整的CRUD操作：创建、读取、更新、删除联系人和自定义字段
动态发现：按关键字查找阶段、自定义字段和源
智能日期筛选：自然语言日期（“最近7天”、“本月”）
批量操作：一次最多更新100个联系人
副本检测：符合FUB标准的重复检查 跟进老板 联系人
智能高速缓存：重复查询速度提高4.6倍，缓存自动失效
自动分页：无缝处理大型 跟进老板 数据集（1000+条记录）
速率限制：针对API节流的内置保护

📊 数据管理

联系人/人员：全面管理，按阶段、来源、用户、标签、日期进行动态过滤
自定义字段：创建、管理和动态搜索自定义字段
通话和活动：从访问呼叫日志和活动事件 跟进老板
交易和任务：跟踪内部交易和任务 跟进老板
管道和阶段一起工作 跟进老板 销售渠道
用户和团队：管理 跟进老板 团队成员

🔧 高性能

动态发现：AI发现存在哪些数据以及如何查询
智能日期筛选：“最近7天”、“本月”、“超过30天”
批量更新：在一次操作中更新多个联系人（速度快10倍）
定制加工：执行Python代码进行数据聚合和分析
增强错误：带有有用建议的上下文错误消息
综合录井：所有操作都记录到文件中
异步性能：高性能异步/等待架构
多客户端支持：适用于Cursor、Claude Desktop、Cline、Continue.dev和任何兼容MCP的客户端

安装

先决条件

Python 3.9或更高版本
A. 跟进老板 具有API访问权限的帐户
你的 跟进老板 API密钥(拿过来)

快速设置

克隆存储库:

git clone https://github.com/benlaube/fub-mcp.git
cd fub-mcp

创建虚拟环境:

python3 -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

安装依赖项:
```
pip install -r requirements.txt
```

配置您的Follow-Up Boss API密钥:

cp .env.example .env
# Edit .env and add your FUB_API_KEY from Follow Up Boss

配置

此MCP服务器与 任何AI客户端 其支持模型上下文协议。只需配置一次，即可与多个AI助手一起使用。

适用于克劳德桌面

添加到 ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "follow-up-boss": {
      "command": "python",
      "args": ["-m", "fub_mcp.server"],
      "cwd": "/path/to/fub-mcp",
      "env": {
        "PYTHONPATH": "/path/to/fub-mcp/src",
        "FUB_API_KEY": "your-follow-up-boss-api-key"
      }
    }
  }
}

对于其他MCP客户端

看 docs/guides/MULTI_CLIENT_SETUP.md 有关以下内容的详细设置说明：

克莱恩 （VS代码扩展）
Continue.dev
其他MCP兼容客户端

使用示例

查询跟进老板联系人

{
  "tool": "get_people",
  "arguments": {
    "limit": 100,
    "sort": "-created"
  }
}

在Follow Up Boss中创建新联系人

{
  "tool": "create_person",
  "arguments": {
    "firstName": "John",
    "lastName": "Doe",
    "email": "john.doe@example.com",
    "phone": "+1-555-123-4567",
    "source": "Website"
  }
}

检查重复联系人

{
  "tool": "check_duplicates",
  "arguments": {
    "email": "john.doe@example.com",
    "phone": "+1-555-123-4567",
    "firstName": "John",
    "lastName": "Doe"
  }
}

自定义跟进老板查询及处理

{
  "tool": "execute_custom_query",
  "arguments": {
    "description": "Team performance report",
    "endpoints": [
      {"endpoint": "/people", "dateField": "created"},
      {"endpoint": "/calls", "dateField": "created"}
    ],
    "dateRange": {
      "start": "2025-01-01",
      "end": "2025-01-31"
    },
    "processing": "result = {'total_leads': len(data['people']), 'total_calls': len(data['calls'])}"
  }
}

可用工具（共32个）

跟进老板联系管理

get_people -列出联系人 跟进老板
get_person -获取具体联系方式
create_person -新建 跟进老板 联系
update_person -更新现有联系人
delete_person -删除联系人
search_people -搜索 跟进老板 联系人
check_duplicates -查找重复联系人

跟进老板自定义字段

get_custom_fields -列出所有自定义字段
get_custom_field -获取特定的自定义字段
create_custom_field -创建新的自定义字段
update_custom_field -更新自定义字段
delete_custom_field -删除自定义字段

跟进老板活动数据

get_calls, get_call -电话通话记录
get_events, get_event -活动事件
get_notes, get_note -联系方式
get_appointments, get_appointment -预约时间

跟进老板的销售数据

get_deals, get_deal -交易跟踪
get_tasks, get_task -任务管理
get_pipelines, get_pipeline -销售渠道
get_stages, get_stage -管道阶段

跟进Boss用户管理

get_users, get_user -团队成员
get_me -当前用户信息

高级查询

execute_custom_query -使用Python处理的自定义查询

看 docs/reference/AVAILABLE_TOOLS.md 获取完整的工具文档。

性能和效率

智能高速缓存

速度提高4.6倍 重复查询
数据更改时自动缓存失效
可配置的缓存大小（默认值：1000个条目）

高效的内存使用

100个联系人：约169 KB
1000个联系人：约1.65 MB
大型数据集的最小内存占用

智能分页

自动处理 跟进老板 API限制（每个请求100条记录）
通过适当的速率限制无缝获取1000+条记录
没有超时或节流问题

跟进Boss API集成

此服务器实现了完整 跟进老板 API v1规范：

完全支持REST API
自动速率限制和重试逻辑
全面的错误处理
通过API密钥进行安全身份验证

有关 跟进老板 API，访问：跟进Boss API文档

测试

服务器包括全面的测试，涵盖所有 跟进老板 集成点：

# Run all tests
pytest tests/

# Run with verbose output
pytest tests/ -v

# Run specific test category
pytest tests/test_crud.py

测试结果：26/26测试通过✅

文档

📁 更多文档

看 docs/ 获取完整的文档索引。

安全与最佳实践

API密钥安全

✅ API密钥仅存储在环境变量中
✅ 永远不要将API密钥提交到版本控制
✅ 通过以下方式进行安全身份验证 跟进老板 API

数据保护

✅ 自定义查询的沙盒代码执行
✅ 所有操作的输入验证
✅ 限速保护 跟进老板 API
✅ 全面的错误处理

贡献

改进贡献 跟进老板 欢迎使用MCP服务器！请随时提交问题或拉取请求。

支持

关于以下问题：

此MCP服务器: 打开一个问题
跟进老板API: FUB支持
模型上下文协议: MCP文件

许可证

MIT许可证-请参阅许可证详细信息文件

致谢

专为 跟进老板 CRM平台
由...驱动模型上下文协议（MCP）
灵感源自 JavaScript实现
跟进老板 API文件： docs.followupboss.com

由以下材料制成❤️ 为“跟进老板”社区

Follow Up Boss®是Follow-Up Boss，LLC的注册商标。该项目与Follow-Ups Boss没有正式关联或认可。