Back to MCP directory
publicPublicdnsLocal runtime

mcp-server-receipt

MCP协议兼容的LLM自动整理收据文件的服务,通过提取收据中的日期、金额和公司名,按照指定格式重命名并存储文件。

article

README

🚀 MCP服务器收据工具

MCP服务器收据工具是一个由MCP协议支持的大语言模型(LLM)驱动的服务器,可自动整理收据文件。它能为LLM提供上下文,使其依据指定规则处理和存储收据文件。

🚀 快速开始

本工具可指示LLM按照特定命名规则和存储位置对收据PDF进行分类。LLM会从收据PDF中提取日期、金额和公司名称,并以标准格式(YYYYMMDD_金額_会社名.pdf)重命名文件并保存。

✨ 主要特性

  • 借助大语言模型自动处理收据文件。
  • 按照特定规则对收据PDF进行分类和重命名。
  • 可自定义输入和输出目录。

📦 安装指南

克隆仓库后进行构建和使用:

# 克隆仓库
git clone https://github.com/soshi-morita/mcp-server-receipt.git

# 切换到目录
cd mcp-server-receipt

# 安装依赖项
npm install

# 构建
npm run build

💻 使用示例

基础用法

启动服务器后,为LLM提供处理收据的指示,LLM会自动完成收据文件的处理。

高级用法

可通过以下命令进行调试:

node dist/index.js <输入目录> <输出目录>

例:

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

📚 详细文档

提示

  • gen-receipt-filename
    • 附加的收据文件中提取信息,生成标准化文件名的指示。
    • 参数:
      • none

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许可证。

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client