项目简介

invoice-parser-mcp 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在与 Claude 等大型语言模型 (LLM) 配合使用。该服务器的核心功能是将 Claude 从发票 PDF 文件中解析和提取的数据，自动整理并存储到 Google Sheets 电子表格中。通过预定义的 MCP 工具，Claude 可以轻松调用此服务器的功能，实现发票数据的自动化管理和记录。

主要功能点

发票数据提取与转存: Claude 可以从发票 PDF 文件中提取关键信息，例如：
- 账单日期（可选）
- 发 bill 方/商家（可选）
- 账单条目和金额
Google Sheets 自动同步: 提取的发票数据会被自动整理并追加到指定的 Google Sheets 电子表格中，方便用户进行统一管理和查阅。
结构化数据存储: 数据在 Google Sheets 中以结构化的形式存储，包括表头（日期、发 bill 方、项目、金额）和数据行，方便后续的数据分析和处理。

安装步骤

配置 Google Cloud 项目:
- 访问 Google Cloud Console 创建或选择现有项目。
- 在项目中启用 Google Sheets API。
- 创建 服务账号 并下载 JSON 密钥文件 (credentials.json)。
- 将下载的 'credentials.json' 文件保存到服务器的合适位置。
安装 MCP 服务器:
- 确保你的环境中已安装 Node.js 和 npm。
- 打开终端，执行以下命令安装 'invoice-parser-mcp' 包：
```
npm install @rikukawa/invoice-parser-mcp
```

更新 MCP 配置文件:

MCP 客户端 (如 Claude) 需要配置 MCP 服务器的连接信息。在客户端的 MCP 配置文件中，添加或更新 'mcpServers' 部分，配置 'invoice-parser' 服务器：

{
  "mcpServers": {
    "invoice-parser": {
      "command": "node",
      "args": ["/path/to/node_modules/@rikukawa/invoice-parser-mcp/build/index.js"],
      "env": {
        "GOOGLE_CREDENTIALS_PATH": "/path/to/credentials.json", //  Google Cloud 服务账号 JSON 密钥文件路径 (请替换为实际路径)
        "SPREADSHEET_ID": "your-spreadsheet-id"             //  Google Sheets 电子表格 ID (请替换为实际 Spreadsheet ID)
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

注意:

'/path/to/node_modules/@rikukawa/invoice-parser-mcp/build/index.js' 需要替换为实际的 'index.js' 文件路径。通常，如果你在项目根目录下执行 'npm install'，该路径会是 'node_modules/@rikukawa/invoice-parser-mcp/build/index.js'。
'/path/to/credentials.json' 需要替换为你在 Google Cloud Console 下载的 JSON 密钥文件的实际路径。
'your-spreadsheet-id' 需要替换为你想要保存发票数据的 Google Sheets 电子表格的 ID。Spreadsheet ID 通常可以在 Google Sheets 的 URL 中找到。

基本使用方法

在 Claude 中上传发票 PDF 文件。

使用 MCP 工具 'save_to_sheet' 保存数据。在 Claude 中，你可以使用类似以下的 JavaScript 代码调用 'save_to_sheet' 工具 (具体的调用方式取决于 Claude 客户端的实现)：

await use_mcp_tool({
  server_name: "invoice-parser",
  tool_name: "save_to_sheet",
  arguments: {
    items: [
      { item: "商品A", amount: 1000 },
      { item: "商品B", amount: 2000 }
    ],
    invoiceDate: "2023年10月1日",    // 可选：账单日期
    sender: "株式会社〇〇"           // 可选：发 bill 方/商家
  }
});

参数说明:

'server_name': 必须设置为 '"invoice-parser"'，与 MCP 配置文件中定义的服务器名称一致。
'tool_name': 必须设置为 '"save_to_sheet"'，指定要调用的工具名称。
'arguments': 工具的参数，包含以下字段：
- 'items': 必需，账单条目数组，每个条目包含 'item' (项目名称) 和 'amount' (金额)。
- 'invoiceDate': 可选，账单日期，字符串格式。
- 'sender': 可选，发 bill 方/商家名称，字符串格式。

Claude 在解析发票 PDF 后，需要将提取出的数据整理成 'save_to_sheet' 工具所需的 'arguments' 格式，然后调用该工具即可将数据保存到 Google Sheets。

关键词

项目简介

主要功能点

安装步骤

基本使用方法

信息