Invoice Shelf MCP

发票架MCP服务器

用于集成的模型上下文协议（MCP）服务器 发票架此服务器允许LLM（如Claude、ChatGPT）与您的发票架实例交互，以管理客户、发票和付款。

查看官方 发票货架存储库.

特性

• 客户管理：列出并搜索客户。
• 估算管理:

- 使用筛选（状态、搜索、分页）列出估计值。 - 获取详细的估算信息。 - 创建新的估计值。 - 更新现有估计。 - 删除估算。 - 通过电子邮件发送估算。 - 将估算转换为发票。

• 发票管理:

- 列出带有过滤功能（状态、搜索、分页）的发票。 - 获取详细的发票信息。 - 创建新发票。 - 更新现有发票。 - 删除发票。 - 通过电子邮件发送发票。

先决条件

• Node.js（v18或更高版本）
• 发票架实例
• 来自发票架的API令牌

安装

1. 克隆存储库：

   git clone 
   cd invoice-shelf-mcp

1. 安装依赖项：

   npm install
   # or
   pnpm install

1. 构建项目：

   npm run build

配置

创建一个 .env 根目录中的文件（从以下位置复制 .env.example 如果可用）：

INVOICE_SHELF_BASE_URL=https://your-invoice-shelf-domain.com/api/v1
INVOICE_SHELF_API_TOKEN=your_api_token_here

重要：The INVOICE_SHELF_API_TOKEN 在 .env 文件主要用于 测试脚本 以及地方发展。当将此服务器与MCP客户端（如Claude Desktop或AnythingLLM）一起使用时，应直接在 MCP客户端的配置文件 （参见 连接到MCP客户端).MCP客户端的配置将优先。

生成API令牌

您可以使用提供的助手脚本轻松地生成API令牌。

1. 更新您的 .env 使用您的发票架凭据进行归档：

   INVOICE_SHELF_USERNAME=your_email@example.com
   INVOICE_SHELF_PASSWORD=your_password
   INVOICE_SHELF_DEVICE_NAME=mcp-server

1. 运行脚本：

   sh test/api-curl.sh

1. 从响应中复制令牌并更新 INVOICE_SHELF_API_TOKEN 在你的 .env 文件。

备注：如果您使用的是具有SSL问题的自签名证书或本地开发环境，则可能需要设置 NODE_TLS_REJECT_UNAUTHORIZED=0 在你的环境中，但这是 不建议用于生产.

用法

运行服务器

npm start

连接到MCP客户端

将服务器配置添加到您的MCP客户端（例如，Claude Desktop、AnythingLLM）：

{
  "mcpServers": {
    "invoice-shelf": {
      "command": "node",
      "args": ["/path/to/invoice-shelf-mcp/dist/index.js"],
      "env": {
        "INVOICE_SHELF_BASE_URL": "https://your-invoice-shelf-domain.com/api/v1",
        "INVOICE_SHELF_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

可用工具

发展

• 构建: npm run build
• 观看模式: npm run dev
• 日志：检查 logs/ 详细请求/响应日志的目录。

致谢

特别感谢 发票架 为构建一个令人惊叹的开源发票解决方案做出了贡献。