MCP胸部支付
一 MCP(模型上下文协议) 该服务器解析意大利INAZ工资单PDF并将其存储在本地SQLite数据库中。将其连接到任何兼容MCP的人工智能客户端,以分析您的工资历史、搜索工资单项目并获取详细的明细——所有这些都将您的数据保存在您的机器上。
安装
要求: Python 3.10+, 紫外线
克隆存储库并安装依赖项:
git clone https://github.com/morettimarco/MCP-Buste-Paga.git
cd MCP-Buste-Paga
uv sync验证它是否运行:
uv run mcp-buste-paga领取工资单
一旦服务器连接到AI客户端(见下文),请助手接收您的工资单PDF:
“从~/Documents/Buste获取我的工资单”
这 ingest_payslips 该工具将递归扫描目录 .pdf 文件,解析每个文件,并存储数据。通过SHA-256哈希自动跳过重复项。
数据库位置
所有数据都存储在本地SQLite数据库中:
~/.mcp-buste-paga/buste_paga.db该目录在首次运行时自动创建。数据库包含四个表:
| 表 | 说明 |
|---|---|
aziende | 公司信息(名称、财务代码、INPS/INAIL代码) |
dipendenti | 员工资料(姓名、财务代码、雇佣日期、角色、合同) |
buste_paga | 月度工资单摘要(毛额、净额、税款、TFR等) |
voci_corpo_busta | 个人工资单行项目(基本工资、加班费、扣除额等) |
可用工具
| 工具 | 说明 |
|---|---|
ingest_payslips | 扫描目录中的PDF工资单,解析并存储它们。返回摄入/跳过/失败文件的摘要。 |
get_employee_summary | 获取员工个人资料和公司详细信息,以及存储的工资单数量。 |
get_salary_history_tool | 获取最近一个月的工资历史记录(净工资、毛工资、扣除额)。可选择按年份过滤。 |
get_payslip_details_tool | 按月份和年份获取特定工资单的完整明细,包括所有行项目。 |
search_payslip_items | 按关键字(如“Straordinario”、“Ferie”、“Ticket”)搜索工资条行项目,包括每月和总计。 |
连接到AI客户端
克劳德桌面
编辑 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)或 %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"buste-paga": {
"command": "/full/path/to/uv",
"args": [
"--directory",
"/full/path/to/MCP-Buste-Paga",
"run",
"mcp-buste-paga"
]
}
}
}注: 使用绝对路径。找到你的uv路径与which uv.
重新启动克劳德桌面。聊天输入中的锤子图标确认服务器已连接。
克劳德代码(CLI)
添加到您的项目 .mcp.json 或运行:
claude mcp add buste-paga -- uv --directory /full/path/to/MCP-Buste-Paga run mcp-buste-pagaChatGPT桌面
ChatGPT Desktop通过其设置支持MCP服务器。首选 设置>测试版功能>MCP服务器,单击 添加,并配置:
- 姓名: 胸部 支付
- 命令:
/full/path/to/uv - 论据:
--directory /full/path/to/MCP-Buste-Paga run mcp-buste-paga
光标
添加 .cursor/mcp.json 在项目根目录中:
{
"mcpServers": {
"buste-paga": {
"command": "/full/path/to/uv",
"args": [
"--directory",
"/full/path/to/MCP-Buste-Paga",
"run",
"mcp-buste-paga"
]
}
}
}帆板运动
添加 ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"buste-paga": {
"command": "/full/path/to/uv",
"args": [
"--directory",
"/full/path/to/MCP-Buste-Paga",
"run",
"mcp-buste-paga"
]
}
}
}隐私
所有工资单数据都会被解析并存储在您的计算机上。没有数据发送到外部服务。AI客户端仅通过上述MCP工具访问数据。
许可证
麻省理工学院
