使用说明
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，重新启动，完成 - 4个实用工具 对于批量操作：
bimp_fetch_all,bimp_batch_read,bimp_bulk_update,bimp_nomenclature_findByArticle - 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=000001398
服务身份验证：
BIMP_AUTH_PROVIDER=service
BIMP_AUTH_URL=https://platform.hey.ua/bimp-auth
BIMP_AUTH_KEY=your-service-auth-key
BIMP_BASE_URL=https://app.bimpsoft.com
2.安装并运行
npm install
npm start
对于自动重新加载的开发：
npm run dev
3.连接您的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_nomenclature_findByArticle |
通过本地筛选按商品/SKU查找命名记录 |
提示
| 提示 | 描述 |
|---|---|
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
