Vyapar MCP

Vyapar MCP服务器

Vyapar MSME业务管理应用程序的模型上下文协议（MCP）服务器。该服务器提供36个基于人工智能的工具，用于管理库存、发票、付款、客户等。

实时服务器

生产URL： https://mcp.felon.in

特性

库存管理

• 获取、创建和更新产品
• 库存管理（加、减、置）
• 具有阈值配置的低库存警报
• 条形码/HSN码支持
• 产品的印地语名称支持

发票生成

• 创建发票、报价单、形式发票、交货时间表
• 自动GST计算（CGST/SGST/IGST）
• 使用UPI二维码生成PDF
• 发票号码自动生成
• 多付款状态跟踪

UPI付款

• 生成UPI支付二维码（符合NPCI标准）
• 解析UPI QR字符串
• 验证UPI ID
• 支持所有主要的UPI应用程序

WhatsApp集成

• 通过WhatsApp共享发票
• 带有UPI深度链接的付款提醒
• 订单确认
• 向供应商发出低库存警报

分析和报告

• 每日业务报告
• 销售分析（周/月/年）
• 按类型分列的付款明细
• 顶级产品分析
• 未付款项跟踪

商品及服务税计算

• 计算CGST/SGST/IGST
• 反向商品及服务税计算（从含税总额开始）
• 按类别划分的商品及服务税税率建议
• GSTIN验证与状态提取

客户与供应商管理

• 客户CRUD操作
• 未清余额跟踪
• 信用额度管理
• 有付款条件的供应商管理

安装

npm install
npm run build

配置

创建 .env 文件基于 .env.example:

SUPABASE_URL=https://your-project.supabase.co
SUPABASE_SERVICE_KEY=your-service-key
PORT=3000
MCP_HTTP_MODE=true

跑步

开发（STDIO模式）

npm run dev

生产（HTTP模式）

npm start

或者使用显式HTTP模式：

MCP_HTTP_MODE=true npm start

部署

此服务器已配置为使用Nixpack进行部署。只需推送到您的托管提供商（Railway、Render等），它就会自动构建和部署。

这 nixpacks.toml 该文件包括PDF生成和图像处理所需的所有系统依赖项。

API端点（HTTP模式）

认证

所有经过身份验证的端点都需要在Authorization标头中使用有效的Supabase JWT令牌：

Authorization: Bearer 

完整工具参考（36个工具）

库存工具（5）

get_products

获取带有筛选选项的产品/库存项目列表。

get_product

通过ID获取特定产品的详细信息。

create_product

将新产品添加到库存中。

update_stock

更新产品的库存数量。

get_inventory_alerts

获取库存不足或缺货的产品列表。

______________________________________________________________________

客户工具（4）

get_customers

获取具有搜索功能的客户列表。

get_customer

获取特定客户的详细信息。

create_customer

添加新客户。

update_customer_balance

更新客户的未清余额。

______________________________________________________________________

交易工具（2）

get_transactions

使用筛选器获取交易列表。

create_transaction

记录新的付款/交易。

______________________________________________________________________

发票工具（5）

get_invoices

使用筛选器获取发票/报价列表。

get_invoice

获取特定发票的详细信息。

create_invoice

使用行项目创建新的发票或报价单。

行项目架构：

update_invoice_status

更新发票的状态。

generate_invoice_pdf

为发票生成PDF。

退货： Base64编码的PDF、文件名和内容类型。

______________________________________________________________________

UPI/支付工具（3）

generate_upi_qr

生成用于接收付款的UPI支付二维码。

退货： QR图像为base64、UPI深度链接和UPI字符串。

parse_upi_qr

解析UPI二维码字符串并提取付款详细信息。

退货： 解析的详细信息（收款人UPI ID、姓名、金额等）

validate_upi_id

验证UPI ID的格式是否正确。

退货： UPI ID和验证结果。

______________________________________________________________________

WhatsApp工具（4）

share_invoice_whatsapp

准备发票以便通过WhatsApp共享。

退货： 格式化消息和WhatsApp深度链接。

send_payment_reminder

为WhatsApp准备付款提醒消息。

send_order_confirmation

为WhatsApp准备订单确认消息。

send_low_stock_alert

通过WhatsApp为供应商准备一条低库存再订购消息。

______________________________________________________________________

GST工具（4）

calculate_gst

计算给定金额的商品及服务税（CGST/SGST或IGST）。

退货： 基本金额、商品及服务税明细（CGST/SGST或IGST）、总额和格式化文本。

calculate_gst_inclusive

根据含GST的总额计算基础金额。

退货： 基本金额、商品及服务税金额和总额。

suggest_gst_rate

为某一产品类别建议适当的商品及服务税税率。

退货： 类别和建议的商品及服务税税率。

validate_gstin

验证GSTIN格式并提取状态信息。

退货： GSTIN、有效性状态和状态（如果有效）。

______________________________________________________________________

分析工具（4）

get_daily_report

获取每日业务报告，包括销售、交易、费用和顶级产品。

退货： 收入、订单数、支出、顶级产品、付款明细。

get_sales_analytics

获取一段时间的销售分析。

退货： 收入趋势、付款明细、增长百分比、顶级产品。

get_business_summary

获取整体业务摘要。

退货： 总产品、客户、收入、交易、发票、未付金额、库存价值。

get_outstanding_payments

获取未付款客户列表。

退货： 按未清余额排序的客户数组。

______________________________________________________________________

费用工具（2）

get_expenses

获取业务费用清单。

create_expense

记录新的业务支出。

______________________________________________________________________

供应商工具（2）

get_suppliers

获取供应商列表。

create_supplier

添加新供应商。

______________________________________________________________________

用户工具（2）

get_user

获取用户/店铺资料详细信息。

update_user

更新用户/店铺资料。

______________________________________________________________________

Supabase架构

服务器需要Supabase中的以下表：

请参阅 types/index.ts 文件以获取详细的模式定义。

示例用法

生成UPI二维码

curl -X POST https://mcp.felon.in/mcp/tools/call \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_SUPABASE_TOKEN" \
  -d '{
    "name": "generate_upi_qr",
    "arguments": {
      "payee_upi_id": "myshop@upi",
      "payee_name": "My Shop",
      "amount": 500,
      "transaction_note": "Invoice #1234"
    }
  }'

创建发票

curl -X POST https://mcp.felon.in/mcp/tools/call \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_SUPABASE_TOKEN" \
  -d '{
    "name": "create_invoice",
    "arguments": {
      "user_id": "your-user-id",
      "items": [
        {
          "name": "Product A",
          "quantity": 2,
          "unit_price": 500,
          "gst_rate": 18
        }
      ],
      "customer_id": "customer-id"
    }
  }'

获取每日报告

curl -X POST https://mcp.felon.in/mcp/tools/call \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_SUPABASE_TOKEN" \
  -d '{
    "name": "get_daily_report",
    "arguments": {
      "user_id": "your-user-id",
      "date": "2024-01-26"
    }
  }'

安全

• 所有工具调用都需要Supabase JWT身份验证
• 用户只能访问自己的数据（强制服务器端）
• 实行费率限制以防止滥用
• CORS已为移动应用程序源配置

许可证

麻省理工学院