Invoice Ninja MCP

发票忍者MCP服务器

MCP（模型上下文协议）服务器 发票忍者 v5.通过Claude创建发票、管理客户、记录付款等。

特性

7个类别的26个工具：

系统

• test-connection -验证API凭据和实例连接

发票 主要的，重要的

• list-invoices -列出/筛选/搜索发票
• get-invoice -获取包含行项目的完整发票详细信息
• create-invoice -创建发票草稿
• update-invoice -更新发票字段和行项目
• delete-invoice -软删除发票
• send-invoice-email -通过电子邮件向客户发送发票
• bulk-invoice-action -标记已发送/已支付、存档、取消、克隆以报价

客户

• list-clients -列出/搜索客户
• get-client -通过联系人获取客户详细信息
• create-client -创建具有联系人的客户
• update-client -更新客户端详细信息
• delete-client -软删除客户端

产品

• list-products -列出产品以供行项目参考
• get-product -获取产品详细信息和定价

支付

• list-payments -列出付款记录
• get-payment -获取付款详细信息
• create-payment -根据发票记录付款

语录

• list-quotes -列出报价
• get-quote -获取报价详情
• create-quote -创建报价（结构与发票相同）
• update-quote -更新报价
• bulk-quote-action -批准、转换为发票、标记已发送

开支

• list-expenses -列出费用
• get-expense -获取费用明细
• create-expense -创建支出记录

配置

你需要两件事：

1. 发票忍者URL -您的Invoice Ninja实例URL（例如。， https://invoicing.co 或您的自托管URL）
2. API代币 -从发票生成Ninja:设置>帐户管理>API令牌

安装

克劳德桌面

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

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

{
  "mcpServers": {
    "invoice-ninja": {
      "command": "npx",
      "args": ["-y", "invoice-ninja-mcp-server"],
      "env": {
        "INVOICE_NINJA_URL": "https://your-instance.invoicing.co",
        "INVOICE_NINJA_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

然后重新启动Claude Desktop。

克劳德代码

claude mcp add invoice-ninja \
  -e INVOICE_NINJA_URL=https://your-instance.invoicing.co \
  -e INVOICE_NINJA_API_TOKEN=your_api_token_here \
  -- npx -y invoice-ninja-mcp-server

光标

添加 .cursor/mcp.json 在项目根目录中（或 ~/.cursor/mcp.json 全球）：

{
  "mcpServers": {
    "invoice-ninja": {
      "command": "npx",
      "args": ["-y", "invoice-ninja-mcp-server"],
      "env": {
        "INVOICE_NINJA_URL": "https://your-instance.invoicing.co",
        "INVOICE_NINJA_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

发展

先决条件

• Node.js>=18
• pnpm

设置

pnpm install
pnpm run build

观看模式

pnpm run watch

本地测试

创建一个 .env 包含您的凭据的文件（已在 .gitignore):

INVOICE_NINJA_URL=https://your-instance.invoicing.co
INVOICE_NINJA_API_TOKEN=your_api_token_here

然后将MCP配置指向本地版本：

{
  "mcpServers": {
    "invoice-ninja": {
      "command": "node",
      "args": ["/path/to/invoice-ninja-mcp/dist/index.js"],
      "env": {
        "INVOICE_NINJA_URL": "https://your-instance.invoicing.co",
        "INVOICE_NINJA_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

工作流示例

1. “列出我的客户”-> list-clients
2. “为Acme Corp开具发票，咨询时间为10小时，每小时150美元”-> list-clients （查找ID）-> create-invoice
3. “发送该发票”-> send-invoice-email
4. “标记为已付款”-> bulk-invoice-action 和 mark_paid

许可证

麻省理工学院