Inflow MCP Server

inFlow库存MCP服务器

一个模型上下文协议（MCP）服务器，它提供了与 inFlow库存 API这使得像Claude这样的人工智能助手能够管理您的库存、订单、客户等。

特性

• 产品：列出、搜索、创建、更新产品并检查库存水平
• 销售订单：创建和管理客户订单
• 采购订单：创建和管理供应商采购订单
• 客户和供应商：管理客户和供应商记录
• 库存操作：库存调整、转移、盘点和制造订单
• 参考数据：地点、类别、定价方案、付款条件、货币、税码
• 网络钩子：订阅inFlow事件

先决条件

• Node.js 18或更高版本
• 带有API附加组件的活动inFlow库存订阅
• inFlow API证书（公司ID和API密钥）

安装

# Clone or copy the server files
cd inflow-mcp-server

# Install dependencies
npm install

# Build the TypeScript
npm run build

配置

获取API凭据

1. 登录您的inFlow库存帐户
2. 首选 设置 > 集成
3. 找到你的 公司编号 在集成页面上
4. 点击 添加新的API密钥 生成新密钥

环境变量

设置以下环境变量：

# Required
export INFLOW_COMPANY_ID="your-company-id"
export INFLOW_API_KEY="your-api-key"

# Optional
export INFLOW_BASE_URL="https://cloudapi.inflowinventory.com"  # Default
export INFLOW_API_VERSION="2025-06-24"  # Default API version
export INFLOW_RATE_LIMIT="60"  # Requests per minute (default: 60)
export INFLOW_REQUEST_TIMEOUT="30000"  # Request timeout in ms (default: 30000)
export INFLOW_MAX_RETRIES="3"  # Max retries on 5xx/429 errors (default: 3)
export INFLOW_RETRY_DELAY="1000"  # Initial retry delay in ms (default: 1000)
export INFLOW_DEBUG="true"  # Enable debug logging (default: false)

Claude桌面配置

添加到您的Claude Desktop配置文件中：

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "inflow-inventory": {
      "command": "node",
      "args": ["/path/to/inflow-mcp-server/dist/index.js"],
      "env": {
        "INFLOW_COMPANY_ID": "your-company-id",
        "INFLOW_API_KEY": "your-api-key"
      }
    }
  }
}

可用工具

产品管理

销售订单

采购订单

客户

供应商

库存操作

参考数据

网络钩子

使用示例

产品列表

List all active products in the "Electronics" category

创建销售订单

Create a sales order for customer "Acme Corp" with:
- 5 units of product SKU-001 at $29.99 each
- 10 units of product SKU-002 at $15.00 each
Required by next Friday

检查库存

What's the current stock level for product "Widget Pro" across all locations?

创建库存转移

Transfer 50 units of "Widget Pro" from "Main Warehouse" to "Retail Store"

API功能

过滤

大多数列表操作都支持过滤。例如：

list_products with name="Widget" and isActive=true

分页

大型结果集被分页。使用 skip 和 count 参数：

• count：要返回的记录数（最多100条）
• skip：要跳过的记录数

注： 默认页面大小为20条记录。始终指定 count 当你需要所有记录时。

排序

所有列表操作都支持排序：

• sort：要排序的属性名称（例如，“name”、“modifiedDate”、“orderDate”）
• sortDesc：设置为 true 按降序排列

list_products with sort="modifiedDate" and sortDesc=true

总数

要获取匹配记录的总数（对分页UI很有用），请使用 includeCount:

list_sales_orders with status="Open" and includeCount=true

答复包括：

{
  "data": [...],
  "totalCount": 42
}

智能搜索

某些端点支持 smart 用于跨多个字段进行模糊搜索的参数：

list_customers with smart="acme"  // Searches name, email, phone
list_sales_orders with smart="SO-2025"  // Searches order fields

包含

使用 include 获取相关数据的参数：

get_sales_order with include=["customer", "lines", "lines.product"]

并发控制

更新记录时，包括 timestamp 从原始记录中删除字段以防止冲突。

速率限制

inFlow API的速率限制为每分钟60个请求。此服务器实现：

• 令牌桶速率限制：自动调整请求的速度以保持在限制范围内
• 自动重试：对5xx错误和速率限制（429）响应进行检索，并采用指数回退
• 可配置的限制：通过以下方式覆盖 INFLOW_RATE_LIMIT 环境变量

错误处理

服务器从inFlow API返回描述性错误消息。常见错误包括：

• 401未经授权：API密钥无效
• 404未找到：资源不存在
• 409冲突：时间戳不匹配（记录已被修改）
• 429请求太多：超出速率限制（自动重试）

发展

# Watch mode for development
npm run dev

# Build for production
npm run build

# Run the server
npm start

# Run tests
npm test

# Run tests in watch mode
npm run test:watch

# Run tests with coverage
npm run test:coverage

API文档

• inFlow API文档
• inFlow API支持指南

许可证

麻省理工学院