AI导哈

CRM语言模型接口

Super Fireberry MCP是一个专为Fireberry CRM设计的模型上下文协议实现，提供大型语言模型与CRM数据交互的高保真接口。

  • by TheOctMind
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 TheOctMind/super-fireberry-mcp

使用说明

超级火莓MCP

概述

Super Fireberry MCP是专门为Fireberry CRM设计的模型上下文协议（MCP）的生产级实现。它为大型语言模型（LLM）提供了一个高保真接口，以便使用自然语言与CRM数据进行交互。

该服务器充当智能中间件，将FireberryRESTneneneba API的复杂性抽象为一组强大的自文档工具。

建筑

该项目建立在模块化的面向服务架构之上，确保了高性能和类型安全。

graph TD
    A[LLM / Claude] -->|MCP Protocol| B[Super Fireberry Server]
    B -->|Normalization Layer| C[API Service]
    C -->|Authenticated REST| D[Fireberry CRM API]
    D -->|JSON Response| C
    C -->|Typed Objects| B
    B -->|Structured Output| A

关键组件

  • 标准化服务：将人类可读的实体名称映射到内部系统代码。
  • 查询引擎：将自然语言意图转换为结构化Fireberry Query API有效载荷。
  • 批处理程序：通过高效的错误恢复管理大容量数据操作。

特性

  • 完整元数据反射：对自定义对象和字段的零配置支持。
  • 电源查询：高级过滤（逻辑AND/OR）、排序和深度分页。
  • 金融一体化：对发票、收据和交易项目的原生支持。
  • 批处理：用于企业数据加载的高吞吐量创建和更新。
  • 关系智能：轻松导航复杂的记录层次结构。

工具集

工具 能力 典型用例
get_objects 系统发现 “有哪些模块可用？”
get_fields 架构检查 “‘项目’的字段是什么？”
query 高级搜索 “查找LinkedIn上状态为“新”的所有潜在客户。”
manage_record 完整CRUD “将帐户#105的状态更新为“活动”。”
get_related_records 层次遍历 “获取链接到此联系人的所有任务。”

安装和设置

先决条件

  • Node.js v18.0.0或更高版本
  • 有效的Fireberry API访问令牌

本地设置

git clone https://github.com/TheOctMind/super-fireberry-mcp.git
cd super-fireberry-mcp
npm install
npm run build

整合

Claude桌面配置

将以下条目添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "super-fireberry": {
      "command": "node",
      "args": ["/absolute/path/to/super-fireberry-mcp/build/index.js"],
      "env": {
        "FIREBERRY_TOKEN_ID": "YOUR_API_TOKEN"
      }
    }
  }
}

路线图

  • v1.1：直接传输文件附件。
  • v1.2：用于实时通知的Webhook集成。
  • v2.0：原生支持Fireberry工作流执行。

贡献

我们欢迎捐款！请查看我们的 贡献指南 了解更多详情。

许可证

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

Built for the Fireberry Ecosystem

相关 MCP