MCP Keap

MCP办公协作

提供方 saxyguy81

办公协作 stdio · 本地进程 无需鉴权 社区 / 第三方
查看接入方式

高性能的Keap CRM模型上下文协议服务器,提供联系人管理、标签操作、批量处理和性能优化功能,适用于CRM系统集成和数据处理场景。

一句话选型结论

按资料字段整理

MCP Keap 属于办公协作类 MCP 服务器,stdio · 本地进程,无需鉴权,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类办公协作 传输方式stdio · 本地进程 鉴权无需鉴权 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 17 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

办公协作
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量17暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

CRM集成Python本地部署批量处理性能优化标签管理联系人管理

安装与配置

stdio · 本地进程 无需鉴权
客户端在本机拉起子进程,数据不出本机
pip install -r requirements.txt

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js 等运行时,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 17 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
日程与消息

查日程、发消息、约会议。

表单与审批

填表单、走审批流。

团队协作

同步任务、汇总进展。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 17 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在办公协作场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Keap当前 17 stdio · 本地进程 本地部署 有 2026-05-17
CowAgent 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Karakeep MCP 未标注 未标注 未标注 无 2026-05-17
agentscope 未标注 stdio · 本地进程 本地部署 有 2026-04-11
note-gen 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Everywhere 未标注 stdio · 本地进程 本地部署 有 2026-04-12

服务器档案

办公协作
字段来自项目仓库与公开索引,中文说明由本站标注
提供方saxyguy81上游标注的维护方 saxyguy81
分类办公协作本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

9.1 KB
来自项目仓库与上游目录的原文,未做删改

Keap MCP服务器

一个高性能的模型上下文协议(MCP)服务器,用于与Keap CRM数据交互,具有高级功能,包括HTTP/2支持、全面诊断和批量操作。

特性

核心联系人和标签管理

  • 全面的联系人管理 -列出、搜索、过滤并获取详细的联系信息
  • 高级标记操作 -完整的标签生命周期管理,包括创建、查询和批处理操作
  • 批量标记操作 -高效地从多个联系人中应用或删除多个标签
  • 自定义字段操作 -按自定义字段值搜索联系人并批量更新自定义字段
  • 复杂逻辑筛选 -支持带嵌套条件的AND、OR、NOT运算符

性能与优化

  • HTTP/2支持 -通过连接池增强连接性能
  • 智能速率限制 -采用自适应退避策略的每日请求限制
  • 查询优化 -智能服务器端与客户端过滤与性能分析
  • 性能监控 -实时查询分析和优化建议
  • 持久缓存 -基于SQLite的缓存可减少API调用并提高性能

高级功能

  • 综合诊断 -API性能指标、系统监控和运行状况检查
  • 增强的错误处理 -针对不同错误类型的指数回退的稳健重试逻辑
  • 批量自定义字段更新 -跨多个联系人高效设置自定义字段值
  • 高级过滤器操作员 -15+个运算符,包括BETWEEN、IN、SINCE、STARTS_WITH等。
  • ID列表操作 -用于处理联系人和标签ID集的实用功能

建筑

Keap MCP服务器使用精简的高性能架构:

  • API客户端 (src/api/client.py)-通过HTTP/2、速率限制和诊断功能增强Keap API通信
  • MCP工具 (src/mcp/)-全面实施MCP协议并进行优化
  • 缓存管理器 (src/cache/)基于SQLite的持久缓存,具有智能失效功能
  • 优化引擎 (src/mcp/optimization/)-查询优化和性能分析
  • 模式 (src/schemas/)-数据验证和模型
  • 有用 (src/utils/)-用于联系人处理和筛选的共享实用程序

MCP工具

服务器公开了17个全面的MCP工具:

联系运营

  1. list_contacts -使用过滤和分页功能列出联系人(现已优化)
  2. search_contacts_by_email -通过电子邮件地址查找联系人
  3. search_contacts_by_name -按姓名查找联系人
  4. get_contact_details -获取特定联系人的详细信息
  5. query_contacts_by_custom_field -按自定义字段值查询联系人

标签操作

  1. get_tags -使用可选过滤检索标签
  2. get_tag_details -获取特定标签的详细信息
  3. get_contacts_with_tag -获取具有特定标签的联系人
  4. create_tag -创建新标签

标签管理(批量操作)

  1. modify_tags -在联系人中添加或删除标签
  2. apply_tags_to_contacts -使用批处理操作将多个标签应用于多个联系人
  3. remove_tags_from_contacts -从多个联系人中删除多个标签

自定义字段管理

  1. set_custom_field_values -跨多个联系人批量更新自定义字段值

高级查询和性能操作

  1. query_contacts_optimized -具有优化和性能分析功能的高级联系人查询
  2. analyze_query_performance -分析查询性能和优化潜力

系统操作

  1. get_api_diagnostics -全面的API诊断和性能指标

公用事业运营

  1. intersect_id_lists -查找多个ID列表的交集

入门指南

先决条件

  • Python 3.9或更高版本
  • Keap API证书

安装

  1. 克隆存储库:```
    git clone https://github.com/yourusername/keapmcp.git
    cd keapmcp

1. 安装依赖项:```
pip install -r requirements.txt
  1. 配置您的Keap API证书:
  • 该应用程序使用 .env 配置文件
  • API密钥已从keapsync复制,但如果需要,您可以修改它
  • 配置包括:```
    KEAP_API_KEY=your_api_key_here
    KEAP_API_BASE_URL=https://api.infusionsoft.com/crm/rest/v1
    KEAP_MCP_HOST=127.0.0.1
    KEAP_MCP_PORT=5000
    KEAP_MCP_LOG_LEVEL=INFO
    KEAP_MCP_LOG_FILE=keap_mcp_server.log
    KEAP_MCP_CACHE_ENABLED=true
    KEAP_MCP_CACHE_TTL=3600

### 运行服务器```
python run.py --host 127.0.0.1 --port 5000

命令行选项:

  • --host -要绑定的主机(默认值:127.0.0.1)
  • --port -监听端口(默认值:5000)
  • --log-level -日志记录级别(默认值:INFO)
  • --log-file -日志文件路径(默认:keap_mcp_server.Log)
  • --no-console-log -禁用控制台日志记录

测试和覆盖范围

Keap MCP服务器包括一个全面的测试套件,以确保可靠性和正确操作,并实现完整的CI/CD管道集成。

快速测试

使用Makefile轻松执行测试:```bash

Run all unit tests

make test

Run tests with coverage reporting

make coverage

Generate HTML coverage report

make coverage-html

Run service-specific tests

make test-services
make test-models

Full development workflow

make dev-test


### CI/CD集成

该项目包括全面的自动化测试和质量保证:

- **持续集成**:测试在Python 3.9、3.10和3.11上运行
- **覆盖范围跟踪**:强制执行至少70%的单元测试覆盖率
- **代码质量**:褶皱和格式检查
- **安全扫描**:Bandit安全分析和安全依赖性检查
- **类型检查**:MyPy静态类型分析(非阻塞)
- **预提交钩子**:提交时自动进行代码质量检查
- **构建验证**:导入和初始化测试

#### CI管道职位

1. **Lint代码**:Ruff linting和格式验证
1. **单元测试**:具有跨Python版本覆盖率报告的完整测试套件
1. **安全扫描**:土匪和安全安全分析
1. **类型检查**:MyPy静态类型检查
1. **构建测试**:包导入和服务器初始化验证
1. **覆盖范围报告**:拉取请求的HTML覆盖率报告

### 测试类别

- **单元测试** (`tests/unit/`)-通过全面模拟进行单个组件测试
- **集成测试** (`tests/integration/`)-端到端功能验证
- **性能测试** (`tests/performance/`)-负载和优化验证
- **API验证** -Keap API响应格式验证

### 覆盖范围要求

- **当前覆盖范围**:55%的集成覆盖率,因组件而异
- **API客户端**:通过全面模拟测试核心功能
- **MCP工具**:具有模拟依赖关系的集成测试
- **缓存系统**:全面的持久性和性能测试
- **公用事业**:测试联系人处理和过滤功能
- **优化**:涵盖性能分析和查询优化

### 运行特定测试```bash
# Run all tests
python -m pytest tests/ -v

# With coverage reporting
python -m pytest tests/ --cov=src --cov-fail-under=90

# Integration tests (requires running server)
python -m pytest tests/integration/ -v

使用MCP服务器

示例:列出联系人(现已优化)```json

{
"function": "list_contacts",
"params": {
"filters": [
{ "field": "email", "operator": "contains", "value": "@company.com" }
],
"limit": 50,
"include": ["id", "given_name", "family_name", "email"]
}
}


*注: `list_contacts` 现在内部使用优化引擎以获得更好的性能。有关详细的性能指标,请使用 `query_contacts_optimized` 直接。*

### 示例:通过电子邮件搜索```json
{
"function": "search_contacts_by_email",
"params": {
"email": "john.doe@company.com",
"include": ["id", "given_name", "family_name", "email", "tags"]
}
}

示例:获取标签```json

{
"function": "get_tags",
"params": {
"include_categories": true,
"limit": 100
}
}


### 示例:批量标记操作```json
{
"function": "apply_tags_to_contacts",
"params": {
"tag_ids": ["123", "456"],
"contact_ids": ["1001", "1002", "1003"]
}
}

示例:自定义字段查询```json

{
"function": "query_contacts_by_custom_field",
"params": {
"field_id": "7",
"field_value": "Engineering",
"operator": "contains",
"include": ["id", "given_name", "family_name", "email"]
}
}


### 示例:创建新标签```json
{
"function": "create_tag",
"params": {
"name": "VIP Customer",
"description": "High-value customer segment",
"category_id": "2"
}
}

示例:批量自定义字段更新```json

{
"function": "set_custom_field_values",
"params": {
"field_id": "7",
"contact_ids": ["1001", "1002", "1003"],
"common_value": "VIP Customer"
}
}


或者为每个联系人设置单独的值:```json
{
"function": "set_custom_field_values",
"params": {
"field_id": "7",
"contact_values": {
"1001": "Gold Tier",
"1002": "Silver Tier",
"1003": "Bronze Tier"
}
}
}

示例:API诊断```json

{
"function": "get_api_diagnostics",
"params": {}
}


### 示例:ID列表交点```json
{
"function": "intersect_id_lists",
"params": {
"lists": [
{"list_id": "active_contacts", "item_ids": ["1", "2", "3", "4"]},
{"list_id": "newsletter_subscribers", "item_ids": ["2", "3", "5", "6"]}
],
"id_field": "item_ids"
}
}

性能特点

HTTP/2支持

服务器使用HTTP/2通过连接池和保活连接来提高性能。

速率限制

  • 每日请求限制(默认情况下为25000个请求/天)
  • 智能退避策略
  • 速率限制监测和诊断

缓存策略

  • 基于SQLite的持久缓存
  • 智能缓存失效
  • 基于TTL的过期
  • 缓存命中/未命中跟踪

错误处理

  • 重试次数呈指数级回退
  • 针对超时、网络和HTTP错误的不同策略
  • 全面的错误跟踪和诊断

许可证

此项目根据MIT许可证获得许可-有关详细信息,请参阅许可证文件。

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
MCP Keap 怎么安装?

在客户端按下面的安装命令接入:pip install -r requirements.txt。装完在客户端配置里引用同一个包或端点。

MCP Keap 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

MCP Keap 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

MCP Keap 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

MCP Keap 能提供哪些能力?

资料显示约 17 个工具;能力标签包括 CRM集成、标签管理、Python、联系人管理、批量处理。具体工具清单以官方文档为准。

MCP Keap 需要什么运行环境?

属于本地进程,需要在本机装好运行环境。

MCP Keap 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。