返回 MCP 目录
public公开dns本地运行

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

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端