超级火莓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