Lightspeed MCP 2026 Complete

光速MCP服务器

Lightspeed零售和餐厅POS平台的完整模型上下文协议（MCP）服务器。

🚀 特性

跨所有领域的77个强大工具

产品和库存（17个工具）

• 产品/项目的完整CRUD操作
• 高级产品搜索和过滤
• 批量更新操作
• 库存跟踪和调整
• 多地点库存管理
• 库存水平监控和警报
• 产品变体和矩阵管理
• 具有层次结构的类别管理

销售和交易（8个工具）

• 创建和管理销售/交易
• 处理付款（现金、卡、支票）
• 销售完成和作废
• 退款处理
• 每日销售总结
• 按客户、员工、注册进行销售

订单与采购（6个工具）

• 采购订单创建和管理
• 订单接收和履行
• 供应商订购工作流程
• 订单发货跟踪

客户（8工具）

• 客户数据库管理
• 高级客户搜索
• 信用账户管理
• 店铺信贷操作
• 客户分析

库存管理（8个工具）

• 库存盘点和审计
• 异地转账
• 库存调整日志
• 库存转移工作流程
• 收货和发货

供应商和供货商（5种工具）

• 供应商管理
• 联系方式
• 订购偏好

员工和职员（6个工具）

• 员工管理
• 时间跟踪
• 角色管理
• 性能跟踪

报告和分析（5个工具）

• 按期间列出的销售报告
• 存货估价报告
• 客户分析
• 员工绩效报告
• 畅销产品分析

附加功能（14个工具）

• 注册/POS终端管理
• 工单/服务管理
• 折扣和促销管理
• 制造商/品牌管理
• 店铺/位置管理
• 税种管理

17个React MCP应用程序（黑暗主题）

1. 仪表盘 -实时业务概览
2. 产品经理 -全面的产品管理
3. 库存管理员 -库存跟踪和转移
4. 销售终端 -快速POS界面
5. 客户经理 -客户数据库
6. 订单经理 -采购订单
7. 员工经理 -员工管理
8. 报表查看器 -业务分析
9. 品类经理 -产品类别
10. 供应商经理 -供应商管理
11. 工单管理器 -服务票
12. 注册经理 -POS控制
13. 传输管理器 -股票转让
14. 折扣经理 -促销活动
15. 分析仪表板 -商业智能
16. 快速销售 -快速结账
17. 低库存警报 -库存警报

📦 安装

npm install @busybee3333/lightspeed-mcp-server

或者克隆并构建：

git clone https://github.com/BusyBee3333/mcpengine.git
cd mcpengine/servers/lightspeed
npm install
npm run build

🔐 认证

Lightspeed使用OAuth2身份验证。您需要：

1. 账户ID -您的光速账号
2. 客户端ID -OAuth客户端标识符
3. 客户端密钥 -OAuth客户端密钥
4. 访问令牌 -（在OAuth流程之后）
5. 刷新令牌 -（在OAuth流程之后）

获取凭据

光速零售（R系列）

1. 访问 光速开发者门户
2. 创建新的API应用程序
3. 记下您的客户端ID和客户端密码

光速餐厅（K系列）

1. 联系您的光速客户经理
2. 请求API凭据
3. 选择试用或生产环境

OAuth流程示例

import { LightspeedClient } from '@busybee3333/lightspeed-mcp-server';

const client = new LightspeedClient({
  accountId: 'YOUR_ACCOUNT_ID',
  clientId: 'YOUR_CLIENT_ID',
  clientSecret: 'YOUR_CLIENT_SECRET',
  apiType: 'retail', // or 'restaurant'
  environment: 'production', // or 'trial'
});

// 1. Get authorization URL
const authUrl = await client.getAuthorizationUrl(
  'https://your-redirect-uri.com/callback',
  'employee:all', // scope
  'random-state-string'
);

// 2. User visits authUrl and authorizes
// 3. Exchange code for tokens
const tokens = await client.exchangeCodeForToken(
  authorizationCode,
  'https://your-redirect-uri.com/callback'
);

console.log(tokens.access_token);
console.log(tokens.refresh_token);

🚀 用法

MCP服务器

设置环境变量：

export LIGHTSPEED_ACCOUNT_ID="123456"
export LIGHTSPEED_CLIENT_ID="your-client-id"
export LIGHTSPEED_CLIENT_SECRET="your-client-secret"
export LIGHTSPEED_ACCESS_TOKEN="your-access-token"
export LIGHTSPEED_REFRESH_TOKEN="your-refresh-token"
export LIGHTSPEED_API_TYPE="retail"  # or "restaurant"
export LIGHTSPEED_ENVIRONMENT="production"  # or "trial"

运行服务器：

npx lightspeed-mcp

Claude桌面集成

增添 claude_desktop_config.json:

{
  "mcpServers": {
    "lightspeed": {
      "command": "npx",
      "args": ["-y", "@busybee3333/lightspeed-mcp-server"],
      "env": {
        "LIGHTSPEED_ACCOUNT_ID": "123456",
        "LIGHTSPEED_CLIENT_ID": "your-client-id",
        "LIGHTSPEED_CLIENT_SECRET": "your-secret",
        "LIGHTSPEED_ACCESS_TOKEN": "your-token",
        "LIGHTSPEED_REFRESH_TOKEN": "your-refresh",
        "LIGHTSPEED_API_TYPE": "retail",
        "LIGHTSPEED_ENVIRONMENT": "production"
      }
    }
  }
}

程序化使用

import { LightspeedMCPServer } from '@busybee3333/lightspeed-mcp-server';

const server = new LightspeedMCPServer(
  'account-id',
  'client-id',
  'client-secret',
  {
    accessToken: 'your-token',
    refreshToken: 'your-refresh-token',
    apiType: 'retail',
    environment: 'production',
  }
);

await server.run();

🛠️ 可用工具

产品工具

• lightspeed_list_products -列出所有带过滤器的产品
• lightspeed_get_product -获取产品详细信息
• lightspeed_create_product -创建新产品
• lightspeed_update_product -更新产品
• lightspeed_delete_product -存档产品
• lightspeed_search_products -高级搜索
• lightspeed_bulk_update_products -批量操作
• lightspeed_get_product_inventory -库存水平
• lightspeed_adjust_product_inventory -调整库存

销售工具

• lightspeed_list_sales -列出交易记录
• lightspeed_get_sale -获取销售详情
• lightspeed_create_sale -创建新销售
• lightspeed_complete_sale -完成交易
• lightspeed_void_sale -无效交易
• lightspeed_add_sale_payment -添加付款
• lightspeed_get_daily_sales -每日总结
• lightspeed_refund_sale -处理退款

客户工具

• lightspeed_list_customers -列出所有客户
• lightspeed_get_customer -客户详细信息
• lightspeed_create_customer -新客户
• lightspeed_update_customer -更新客户
• lightspeed_delete_customer -存档客户
• lightspeed_search_customers -搜索客户
• lightspeed_get_customer_credit_account -店铺信用
• lightspeed_add_customer_credit -添加信用

报表工具

• lightspeed_sales_report -销售分析
• lightspeed_inventory_report -股票估值
• lightspeed_customer_report -客户分析
• lightspeed_employee_performance_report -员工指标
• lightspeed_product_performance_report -畅销商品

…还有50多种工具！

🌐 React应用程序

所有应用程序都是用Vite构建的，并具有现代的黑暗主题。访问它们：

dist/ui/dashboard/index.html
dist/ui/product-manager/index.html
dist/ui/sales-terminal/index.html
...etc

🏗️ 发展

# Install dependencies
npm install

# Build TypeScript
npm run build

# Development mode (watch)
npm run dev

# Build React apps
node build-apps.js

📚 API 文档

光速零售（R系列）

• API 文档
• 基本URL: https://api.lightspeedapp.com/API/V3
• 认证：OAuth2

光速餐厅（K系列）

• API 文档
• 基本URL: https://api.lsk.lightspeed.app
• Auth:OAuth2，具有基本身份验证

🤝 贡献

欢迎投稿！拜托：

1. 克隆该仓库
2. 创建要素分支
3. 进行更改
4. 提交拉取请求

📄 许可证

MIT许可证-有关详细信息，请参阅许可证文件

🆘 支持

• GitHub问题： BusyBee3333/微型发动机
• 文档： MCP引擎文档

🎯 路线图

• \[\]Webhook支持实时更新
• \[\]高级报告仪表板
• \[\]多币种支持
• \[\]电子商务集成工具
• \[\]自定义字段管理
• \[\]高级定价规则
• \[\]忠诚度计划集成

______________________________________________________________________

内置于❤️ by BusyBee3333

部分 MCP发动机 项目-为40多个平台提供完整的MCP服务器。