BIMP MCP
MCP server for BIMP ERP — a Ukrainian cloud ERP for small and medium businesses
Enable LLMs to interact with BIMP data through the Model Context Protocol:
read, create, update entities, perform bulk operations, and analyze business data.
______________________________________________________________________
特性
- 约135个自动生成的工具 来自OpenAPI 3.1规范--编辑
bimp-api.json，重新启动，完成 - 3个实用工具 对于批量操作：
bimp_fetch_all,bimp_batch_read,bimp_bulk_update - 6个MCP提示 使用ERP领域上下文、工作流指南和数据分析模式
- 自动身份验证 --首次呼叫时登录，401时透明令牌刷新
快速开始
先决条件
- Node.js 20+
- A. BIMP ERP 具有API访问权限的帐户
1.配置环境
创建一个 .env 文件（参见 .env.example):
BIMP_BASE_URL=https://app.bimpsoft.com
BIMP_EMAIL=your@email.com
BIMP_PASSWORD=your-password
BIMP_COMPANY_CODE=0000013982.安装并运行
npm install
npm start对于自动重新加载的开发：
npm run dev3.连接您的MCP客户端
添加 claude_desktop_config.json （克劳德桌面）或同等产品：
{
"mcpServers": {
"bimp": {
"command": "npx",
"args": ["tsx", "src/index.ts"],
"cwd": "/path/to/bimp-mcp",
"env": {
"BIMP_EMAIL": "your@email.com",
"BIMP_PASSWORD": "your-password",
"BIMP_COMPANY_CODE": "000001398"
}
}
}
}工具
自动生成（约135个工具）
生成自 bimp-api.json 在启动时。命名： bimp_{entity}_{action}.
| 域 | 示例 |
|---|---|
| 销售 | bimp_salesInvoice_readList, bimp_salesInvoice_create, bimp_invoiceForCustomerPayment_readList |
| 库存 | bimp_nomenclature_readList, bimp_inventory_readList_cursor, bimp_movementOfInventories_create |
| 金融 | bimp_customerPayment_readList, bimp_supplierPayment_create, bimp_cashBox_readList |
| 制造 | bimp_production_order_readList, bimp_production_assembly_create, bimp_specification_read |
| 采购 | bimp_purchaseInvoice_readList, bimp_invoiceForSupplierPayment_create |
| 参考数据 | bimp_counterparty_readList, bimp_employee_readList, bimp_warehouse_readList |
| 认证 | bimp_auth_listCompanies, bimp_auth_switchCompany |
实用工具
| 工具 | 目的 |
|---|---|
bimp_fetch_all | 自动为任何readList分页。支持偏移/计数、光标、页面/页面大小。可选的 enrich 模式获取每条记录的完整细节。 |
bimp_batch_read | 并行读取具有可配置并发性的UUID数组的完整细节。 |
bimp_bulk_update | 批量更新记录，具有批处理并发性和每项错误报告功能。 |
提示
| 提示 | 描述 |
|---|---|
bimp_erp_context | 实体结构、关系、乌克兰术语映射 |
bimp_data_analysis | 数据分析模式、分页怪癖、丰富策略 |
bimp_bulk_operations | 批量操作模式：价格更新、批量编辑、进口 |
bimp_sales_workflow | 销售流程：订单、变现、付款、退货 |
bimp_production_workflow | 生产：规格、订单、组装、材料核销 |
bimp_procurement_workflow | 采购：供应商发票、采购发票、合同 |
测试
npm test # Unit tests (mocked, no API calls)
npm run test:integration # Integration tests (requires env vars)
npm run test:functional # Functional E2E tests (requires env vars)
npm run test:all # All tests