AI导哈

ERP库存管理工具

为Fulfil.io ERP提供MCP服务器，包含29种工具用于库存管理、订单处理、运输跟踪、客户查询、采购、退货、仓库运营和业务分析。

  • by ExpertVagabond
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 ExpertVagabond/fulfil-mcp

使用说明

实现mcp

MCP服务器 Fulfil.io 企业资源计划 --29个工具，用于库存管理、订单处理、发货跟踪、客户查找、采购、退货、仓库运营和业务分析。

建立在 模型上下文协议 与Claude Desktop、Claude Code和任何兼容MCP的客户端无缝集成。通过自动重试、指数退避和速率限制处理连接到Fulfill.io的REST API v2。

工具（29）

库存（5个工具）

工具 说明
list_products 按名称、SKU或带分页的类别搜索产品
get_product 详细的产品信息——价格、重量、类别、可用性
check_inventory 库存水平：手头、可用、预测、最近变动
low_stock_alert 达到或低于再订购阈值的产品
inventory_by_location 仓库位置的库存明细

订单（5个工具）

工具 说明
list_orders 按状态、客户、日期范围搜索订单
get_order 完整的订单详细信息——行项目、金额、运费、付款
order_status 使用承运商信息进行装运和履行跟踪
delayed_orders N天内未发货的订单（履行瓶颈）
recent_orders 按创建日期列出的最新N个订单

发货（2件工具）

工具 说明
list_shipments 按状态、日期、承运商搜索出库货物
shipment_exceptions 逾期和异常状态装运

客户（2个工具）

工具 说明
search_customers 通过姓名、电子邮件或电话查找客户
customer_order_history 终身消费的完整订单历史记录

分析（3个工具）

工具 说明
sales_summary 日期范围内的收入、AOV、税收和州细分
top_products 按收入排名的畅销书
inventory_valuation 存货总价值（数量x成本价）

采购（4个工具）

工具 说明
list_purchase_orders 按状态、供应商、日期范围搜索采购订单
get_purchase_order 采购订单详细信息——行项目、交货日期、供应商信息
overdue_purchase_orders 订单超过预期交付但未完全收到
create_purchase_order_draft 创建包含产品、数量和定价的采购订单草案

退货（3个工具）

工具 说明
list_returns 按状态、日期、原因搜索返回
get_return 退货详情——项目、数量、退款金额、原因
return_rate_report 日期范围内的退货率和最多退货产品

仓库（4个工具）

工具 说明
list_warehouses 所有具有地址、区域和活动状态的仓库
warehouse_utilization 有效SKU、现有单位、可用库存与预留库存
pending_receipts 预计在有逾期标志的仓库进行入库装运
pick_list 按产品和地点分组的综合拣选清单

操作（1个工具）

工具 说明
daily_ops_briefing 早间操作摘要：订单、履行、发货、低库存、异常

快速开始

安装

git clone https://github.com/ExpertVagabond/fulfil-mcp.git
cd fulfil-mcp
npm install
npm run build

配置凭据

设置环境变量：

export FULFIL_API_KEY="your-fulfil-api-key"
export FULFIL_SUBDOMAIN="your-tenant-subdomain"

或使用凭据文件：

mkdir -p ~/.fulfil-mcp
echo "your-fulfil-api-key" > ~/.fulfil-mcp/api-key
echo "your-tenant-subdomain" > ~/.fulfil-mcp/subdomain
chmod 600 ~/.fulfil-mcp/*

跑

# Direct
FULFIL_API_KEY=xxx FULFIL_SUBDOMAIN=yyy node dist/index.js

# Via wrapper (reads from env or credential files)
./fulfil-mcp-wrapper.sh

Claude桌面配置

添加到您的Claude Desktop MCP配置(~/Library/Application Support/Claude/claude_desktop_config.json 在macOS上）：

{
  "mcpServers": {
    "fulfil": {
      "command": "node",
      "args": ["/path/to/fulfil-mcp/dist/index.js"],
      "env": {
        "FULFIL_API_KEY": "your-api-key",
        "FULFIL_SUBDOMAIN": "your-tenant"
      }
    }
  }
}

Claude代码配置

添加 ~/.mcp.json:

{
  "mcpServers": {
    "fulfil": {
      "command": "/path/to/fulfil-mcp/fulfil-mcp-wrapper.sh",
      "env": {
        "FULFIL_API_KEY": "your-api-key",
        "FULFIL_SUBDOMAIN": "your-tenant"
      }
    }
  }
}

用法示例

连接后，向Claude提出自然语言问题，它将调用相应的工具：

库存

“哪些产品的库存低于10件？” “显示所有仓库中4521产品的库存明细。”

订单

“列出过去7天内尚未发货的所有订单。” “获取18923订单的全部详细信息。”

运营

“给我每日行动简报。” “有什么我应该知道的装运例外情况吗？”

采购

“显示我们供应商的逾期采购订单。” “为供应商312创建一份包含500件产品891的采购订单草案。”

分析

“上个月收入排名前十的产品是什么？” “生成2025年第四季度的销售摘要。”

退货

“过去90天的退货率是多少？” “哪些产品的退货率最高？”

仓库

“列出所有仓库及其使用情况。” “为主仓库生成拣货单。”

建筑

src/
  index.ts              MCP server setup + 29 tool registrations
  api.ts                Fulfil.io REST client (retries, rate-limits, backoff)
  tools/
    inventory.ts        Product search, stock levels, low stock alerts
    orders.ts           Sales orders, fulfillment status, delayed orders
    shipments.ts        Outbound shipments, exceptions
    customers.ts        Customer search, order history
    analytics.ts        Sales summaries, top products, valuations
    operations.ts       Daily ops briefing
    purchasing.ts       Purchase orders, overdue POs, draft creation
    returns.ts          Returns, return rate reports
    warehouse.ts        Warehouse listing, utilization, receipts, pick lists

API客户端

这 FulfilClient 类处理与Fulfill.io REST API v2的所有通信：

  • 自动重试 5xx错误和网络故障的指数回退
  • 费率限制处理 随着 Retry-After 标头支持
  • Tryton风格的域过滤器 用于灵活的记录查询
  • 单例模式 --每个服务器生命周期一个客户端实例

Fulfill.io API参考

端点 方法 描述
/model/{model} PUT 使用域筛选器搜索记录
/model/{model}/{id} GET 按ID读取单个记录
/model/{model}/read POST 按ID数组读取多条记录

主要型号： product.product, product.template, sale.sale, sale.line, stock.shipment.out, stock.shipment.in, stock.move, stock.location, party.party, purchase.purchase, purchase.line

发展

# Watch mode (recompile on change)
npm run dev

# Build
npm run build

# Run
npm start

需求

  • Node.js>=18
  • TypeScript 5.3+
  • 具有API访问权限的Fulfill.io帐户

贡献

欢迎捐款。要添加新工具，请执行以下操作：

  1. 在中创建或扩展文件 src/tools/ 随着工具的实施
  2. 从该文件导出处理程序函数
  3. 在中注册该工具 src/index.ts 使用Zod模式和描述
  4. 跑 npm run build 验证编译
  5. 打开拉取请求

请保持工具描述的清晰和具体——它们可以作为人类和人工智能模型的文档。

许可证

麻省理工学院

相关 MCP