mcpField
M
mcp-vindi

mcp-vindi

本地服务
github.com/codespar金融数据2754 周前更新
代码仓库

关于 mcp-vindi

mcp-vindi 是面向 Vindi 计费平台的 MCP 服务，提供定期计费、订阅、账单和支付方式相关工具。适合需要通过 AI 助手或 Agent 管理循环收费业务的团队。

主要功能

  1. 01订阅的创建、查询、取消与重新激活
  2. 02账单的创建、查询、收取与取消
  3. 03客户与产品目录管理
  4. 04退款与支付方式（Payment Profile）管理

适用场景

  1. 01通过 AI 助手查询订阅状态并处理取消或重新激活
  2. 02自动创建账单并重试待处理账单的收费
  3. 03为客户创建支付方式并发起部分或全额退款

MCP 相关

该项目作为 MCP 服务运行，向 MCP 客户端暴露 20 个 Vindi 相关工具，使客户端可以直接调用 Vindi API 完成计费操作。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "codespar-mcp-vindi": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-vindi"
      ],
      "env": {
        "VINDI_API_KEY": "<VINDI_API_KEY>"
      }
    }
  }
}
启动命令npx -y @codespar/mcp-vindi
需要配置的环境变量
VINDI_API_KEY密钥API key for vindi

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@codespar/mcp-vindi0.2.2

工具

20

收录的工具列表 · 更新于 2 周前

参数类型必填说明
plan_idnumber是计划 ID
start_atstring否开始日期（YYYY-MM-DD）
customer_idnumber是客户 ID
payment_method_codestring是支付方式（credit_card、bank_slip、pix）

详细介绍

@codespar/mcp-vindi

面向 Vindi 的 MCP 服务 — 定期计费、订阅和付款计划

npm License: MIT

快速开始

Claude Desktop

添加到 ~/.config/claude/claude_desktop_config.json：

{
  "mcpServers": {
    "vindi": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-vindi"],
      "env": {
        "VINDI_API_KEY": "your-key"
      }
    }
  }
}
Claude Code
claude mcp add vindi -- npx @codespar/mcp-vindi
Cursor / VS Code

添加到 .cursor/mcp.json 或 .vscode/mcp.json：

{
  "servers": {
    "vindi": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-vindi"],
      "env": {
        "VINDI_API_KEY": "your-key"
      }
    }
  }
}

工具（20 个）

工具用途
create_subscription在 Vindi 中创建定期订阅
get_subscription根据 ID 获取订阅详情
list_subscriptions列出订阅，可选筛选条件
create_bill在 Vindi 中创建账单（扣款）
get_bill根据 ID 获取账单详情
list_bills列出账单，可选筛选条件
create_customer在 Vindi 中创建客户
get_customer根据 ID 获取客户详情
create_plan在 Vindi 中创建计费计划
list_plans列出可用的计费计划
update_customer更新客户详情
create_product创建产品（可关联到计划或账单的目录条目）
list_products列出目录中的产品
cancel_subscription立即取消订阅
reactivate_subscription重新激活已取消的订阅
cancel_bill取消待处理的账单
charge_bill重试扣收待处理账单（运行计费工作流）
refund_charge退款（全额或部分）。
create_payment_profile为客户创建付款资料（令牌化卡片 / 已保存的付款方式）
list_payment_profiles列出付款资料，可按客户筛选

身份验证

Vindi 使用 Basic Auth，API 密钥作为用户名，密码留空。

沙盒 / 测试

Vindi 通过控制面板提供沙盒。测试时请使用沙盒 API 密钥。

获取凭据
  1. 前往 Vindi
  2. 创建账户
  3. 前往设置并生成 API 密钥
  4. 设置 VINDI_API_KEY 环境变量

环境变量

变量必填描述
VINDI_API_KEY是来自 Vindi 控制面板的 API 密钥

路线图

v0.2（计划中）
  • cancel_subscription — 取消有效订阅
  • update_subscription — 更新订阅详情
  • list_payment_profiles — 列出客户的付款资料
  • create_discount — 为订阅创建折扣
  • get_charges — 获取扣款详情并应用筛选条件
v0.3（计划中）
  • batch_bills — 在单个请求中创建多张账单
  • financial_reports — 生成财务摘要报告

想要贡献？提交 PR 或请求工具。

链接

企业版

需要为 Agent 付款提供治理、预算限额和审计跟踪？CodeSpar Enterprise 在这些 MCP 服务之上增加策略引擎、付款路由和合规模板。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。