MCP Server Receipt

🚀 MCPサーバーレシートツール

このツールはMCPプロトコルに対応した大規模言語モデル（LLM）を利用して、レシートファイルを自動的に整理するサーバーです。LLMに対して指定されたルールに基づいてレシートファイルを処理し、保存するためのコンテキストを提供します。

このツールは、LLMに特定の命名規則と保存場所に従ってレシートPDFを分類するよう指示します。LLMはレシートPDFから日付、金額、会社名を抽出し、標準形式（YYYYMMDD_金額_会社名.pdf）でファイルをリネームして保存します。

🚀 クイックスタート

このツールを使うには、まずリポジトリをクローンしてからビルドします。

# リポジトリをクローンする
git clone https://github.com/soshi-morita/mcp-server-receipt.git

# ディレクトリに移動する
cd mcp-server-receipt

# 依存関係をインストールする
npm install

# ビルドする
npm run build

✨ 主な機能

• gen-receipt-filename
  • 添付されたレシートファイルから情報を抽出し、標準化されたファイル名を生成する指示
  • パラメータ:
    • none

📦 インストール

上述の「クイックスタート」セクションに記載されている手順に従って、ローカルでビルドしてください。

💻 使用例

基本的な使用法

以下は、このツールの基本的な使用方法です。

node dist/index.js <入力ディレクトリ> <出力ディレクトリ>

例：

node dist/index.js ~/Downloads/receipts ~/Documents/Finance/Receipts

高度な使用法

MCPホストの設定例を以下に示します。

{
  "mcpServers": {
    "mcp-server-receipt": {
      "command": "node",
      "args": [
        "/path/to/mcp-server-receipt/dist/index.js",
        "~/Downloads/receipts", // 入力ディレクトリ
        "~/Documents/Finance/Receipts" // 出力ディレクトリ
      ]
    }
  }
}

🔧 技術詳細

1. サーバーを起動した後、LLMにレシートを処理する指示を与えます。
2. LLMはレシートから情報を抽出し、ファイル名を生成します。
3. LLMはファイルを指定された目標位置にコピーします。

📄 ライセンス

このツールはMITライセンスの下で提供されています。