Fulfil MCP

实现mcp

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

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

   ](https://nodejs.org)

______________________________________________________________________

工具（29）

库存（5个工具）

订单（5个工具）

发货（2件工具）

客户（2个工具）

分析（3个工具）

采购（4个工具）

退货（3个工具）

仓库（4个工具）

操作（1个工具）

______________________________________________________________________

快速开始

安装

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参考

主要型号： 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. 打开拉取请求

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

______________________________________________________________________

许可证

麻省理工学院