@rikukawa/invoice-parser-mcp

Invoice Parser MCP Server

Claude用のMCPサーバーで、請求書PDFから抽出したデータをGoogle Sheetsに自動転記します。

機能

• Claudeが請求書PDFから抽出した以下の情報をGoogle Sheetsに保存
  • 請求日（オプション）
  • 請求元（オプション）
  • 請求項目と金額

セットアップ

1. Google Cloud Projectの設定

   • Google Cloud Consoleで新しいプロジェクトを作成
   • Google Sheets APIを有効化
   • サービスアカウントを作成し、JSONキーをダウンロード
   • ダウンロードしたJSONキーをcredentials.jsonとして保存

2. インストールと設定

# 依存パッケージのインストール
npm install

# ビルド
npm run build

3. MCP設定ファイルの更新

{
  "mcpServers": {
    "invoice-parser": {
      "command": "node",
      "args": ["/path/to/invoice-parser/build/index.js"],
      "env": {
        "GOOGLE_CREDENTIALS_PATH": "/path/to/credentials.json",
        "SPREADSHEET_ID": "your-spreadsheet-id"
      },
      "disabled": false,
      "alwaysAllow": []
    }
  }
}

使用方法

1. Claudeに請求書PDFをアップロード
2. 以下のようにMCPツールを使用してデータを保存

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: "株式会社〇〇"           // オプション
  }
});

スプレッドシートの形式

• ヘッダー行（1行目）

  • A1: 請求日
  • B1: 請求元
  • C1: 項目
  • D1: 金額

• データ行（2行目以降）

  • 1つ目の項目: すべての情報（請求日、請求元、項目、金額）
  • 2つ目以降の項目: 項目と金額のみ（請求日と請求元は空欄）

開発

# 開発用ビルド（ファイル変更の監視）
npm run dev

# 本番用ビルド
npm run build