mcp-server-receipt

Name: mcp-server-receipt
Author: moritasoshi

@moritasoshi

代码仓库

关于 mcp-server-receipt

領収書整理のためのMCPサーバー

基本信息

分类

其他

许可证

MIT license

运行时

node

传输方式

stdio

发布者

moritasoshi

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcp-server-receipt": {
      "command": "node",
      "args": [
        "dist/index.js",
        "<入力ディレクトリ>",
        "<出力ディレクトリ>"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is mcp-server-receipt?

mcp-server-receipt is an MCP protocol server that provides context for LLMs to automatically organize receipt files. It instructs the LLM on naming conventions and storage locations, enabling extraction of date, amount, and company name from receipt PDFs and renaming them to a standardized format (YYYYMMDD_amount_company.pdf) before saving to a specified output directory.

How to use mcp-server-receipt?

Clone the repository, install dependencies (npm install), and build (npm run build). Then configure your MCP host with the command node and arguments pointing to dist/index.js, followed by an input directory and an output directory (e.g., ~/Downloads/receipts and ~/Documents/Finance/Receipts). The server provides a gen-receipt-filename prompt (no arguments) that guides the LLM to process attached receipt files.

Key features of mcp-server-receipt

Provides the gen-receipt-filename prompt for LLM guidance
Extracts date, amount, and company name from receipt PDFs
Renames files to YYYYMMDD_amount_company.pdf
Copies renamed files to a configurable output directory
Supports local build from source with npm
Designed for MCP-compatible LLM hosts

Use cases of mcp-server-receipt

Automating receipt file organization for personal finance
Generating standardized filenames for expense tracking
Integrating with LLM-based document management workflows
Reducing manual file renaming and sorting tasks

FAQ from mcp-server-receipt

What does the gen-receipt-filename prompt do?

It provides instructions to the LLM to extract information from attached receipt files and store them with standardized filenames.

How do I set up the input and output directories?

Configure them as command-line arguments when starting the server, for example: node dist/index.js ~/Downloads/receipts ~/Documents/Finance/Receipts.