AI导哈

发票管理服务器

Számlázz.hu MCP Server是一个用于管理发票和收据的服务器工具，支持多公司环境和会计事务所使用。

  • by Szotasz
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 Szotasz/szamlazz-mcp

使用说明

MCP服务器

MCP 服务器 计算.hu 代理API。在多个企业环境中进行会计和养老金管理，包括会计事务所。

功能

15工具 可用：

类别 工具 描述
企业管理 list_companies 已配置公司列表
add_company 使用API密钥添加新公司
remove_company 公司删除。
set_default_company 改变基本公司。
set_pdf_output_dir 设置PDF输出文件夹
账户 create_invoice 创建账户（正常，收费，预付款，校正）
reverse_invoice 数字中断
get_invoice_pdf 下载PDF
get_invoice_data 查询账户数据。
register_payment 付款的固定。
delete_proforma 取消报酬。
西方 create_receipt 安静的准备。
reverse_receipt 安静的塔。
get_receipt 安静的询问。
send_receipt 轻松发送电子邮件。

多公司支持

对于会计机构：您可以管理多个公司的API密钥，并在每次工具调用时选择一个公司。 company 参数。如果您不提供公司，则使用默认公司。

安装 macOS/Linux

前提条件

1.克隆和构建

git clone https://github.com/Szotasz/szamlazz-mcp.git
cd szamlazz-mcp
npm install
npm run build

Claude Code 设置

claude mcp add szamlazz-hu node /TELJES/ELÉRÉSI/ÚT/szamlazz-mcp/dist/index.js

或者用手 ~/.claude/settings.json 到文件 ：

{
  "mcpServers": {
    "szamlazz-hu": {
      "command": "node",
      "args": ["/TELJES/ELÉRÉSI/ÚT/szamlazz-mcp/dist/index.js"]
    }
  }
}

3. Claude 桌面设置

打开： ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "szamlazz-hu": {
      "command": "node",
      "args": ["/TELJES/ELÉRÉSI/ÚT/szamlazz-mcp/dist/index.js"]
    }
  }
}

重新启动 Claude Desktop。

安装 Windows — 一步一步

第1步：安装Node.js

  1. 打开浏览器并转到 https://nodejs.org/ 页面
  2. 下载 长期支持 长期支持（Long Term Support） .msi 安装程序
  3. 运行安装程序：
    • 点击整个 下一步 戈姆博卡尔
    • 保持选中 “添加到PATH” 选项（默认开启）
    • Kattints 安装，马吉德 完成
  4. 检查它的工作原理： 打开一个 偏执狂 (cmd）或 PowerShell然后输入：
    node --version
    如果输出版本号（例如： v22.x.x）那就好了。

第2步：安装Git（如果还没有）

  1. 去 https://git-scm.com/download/win 页面
  2. 下载并安装 — 默认设置不错，点击完成 下一步-电话
  3. 在命令行检查：
    git --version

没有 Git 的替代方案： 在 GitHub 上，点击绿色 代码 按钮，然后 下载ZIP打包，例如。 C:\szamlazz-mcp\ 进入文件夹，然后跳到4。一步。

步骤3：下载项目（克隆）

新建 偏执狂 (cmd）或 PowerShell-t：

cd C:\
git clone https://github.com/Szotasz/szamlazz-mcp.git
cd szamlazz-mcp

这将创建 C:\szamlazz-mcp 文件夹。您可以选择其他文件夹，例如。 C:\Users\felhasznalo\szamlazz-mcp.

第四步：安装和构建依赖关系

在同一个命令行中：

npm install
npm run build

等他下来如果出现错误，请检查Node.js安装是否成功（1。步骤）。

步骤5：确定路线

在命令行输入 ：

cd dist
echo %cd%\index.js

它指定了确切的路径，例如：

C:\szamlazz-mcp\dist\index.js

记住这条路线 你将需要在下一步。

第 6 步：设置 Claude Desktop

  1. 按下 Win + R 按键 组合
  2. 写入 ： %APPDATA%\Claude 然后按 进入t — 打开文件夹
  3. 查找 claude_desktop_config.json 文件
    • 如果没有这样的文件，请创建它（右键单击→新建→文本文档→重命名） claude_desktop_config.json-ra）
  4. 打开它 记事本 （右键单击 → 打开 → 书签）
  5. 请输入以下内容（将路径替换为 5。步骤）：
{
  "mcpServers": {
    "szamlazz-hu": {
      "command": "node",
      "args": ["C:\\szamlazz-mcp\\dist\\index.js"]
    }
  }
}

来源 ： dupla backlash-t上的窗口(\\一定要在路上使用。

如果文件中有其他内容，则 "mcpServers" 添加到对象 "szamlazz-hu" 部分。

  1. 保存文件
  2. 关闭并重新启动 Claude Desktop

步骤 6/B：设置 Claude Code（如果使用 Claude Code）

Parancsorban：

claude mcp add szamlazz-hu node C:\szamlazz-mcp\dist\index.js

或者手动编辑 %USERPROFILE%\.claude\settings.json 文件 ：

{
  "mcpServers": {
    "szamlazz-hu": {
      "command": "node",
      "args": ["C:\\szamlazz-mcp\\dist\\index.js"]
    }
  }
}

第七步：检查

在 Claude Desktop 或 Claude Code 中打开新对话，然后键入：

“列出已配置的公司”

如果答案是这样的： “没有配置公司。请使用 add_company 工具…” — 那么 安装成功！

Windows 上的故障排除

问题 解决方案
'node' is not recognized Node.js 不在 PATH 中。重新安装并选择“添加到PATH”选项。关闭并重新打开命令行。
'git' is not recognized Git没有安装。安装2。按步骤，或在ZIP下载。
npm ERR! 的 npm install 尝试以管理员身份运行命令行（右键单击→以管理员身份运行）。
Claude Desktop 看不到工具 检查 claude_desktop_config.json 文件：路径正确吗？有双反斜线吗？你重新启动Claude Desktop了吗？
在Windows上配置文件的位置 C:\Users\FELHASZNÁLÓNÉV\.szamlazz-mcp\companies.json
在Windows上保存PDF文件 C:\Users\FELHASZNÁLÓNÉV\Szamlak\{cégnév}\

首次使用

安装完成后，告诉 Claude：

  1. 添加公司：

    “添加我的公司： 例子有限公司， API密钥： xxxxxxxx-xxxx-xxxx-xxxxxxxxxxxx”

  2. 会计师事务所（会计师事务所）：

    “添加客户端Bt，API密钥：yyyyyy-yyyyyy-yyyyyy-yyyyyy”

  3. 下载PDF：

    “下载E-2024-123发票的PDF文件”

  4. 创建账户：

    “向买方有限公司发票，10万福特+27%的增值税，通过转账支付”

  5. 给公司的：

    “从同一家公司下载D-2024-456发票”

配置

配置存储在这里：

  • macOS/Linux： ~/.szamlazz-mcp/companies.json
  • 窗户： C:\Users\FELHASZNÁLÓNÉV\.szamlazz-mcp\companies.json
{
  "companies": {
    "sajat-ceg": {
      "name": "Példa Kft.",
      "apiKey": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
    },
    "ugyfel-bt": {
      "name": "Ügyfél Bt.",
      "apiKey": "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"
    }
  },
  "defaultCompany": "sajat-ceg",
  "pdfOutputDir": "C:\\Users\\felhasznalo\\Szamlak"
}

PDF文件默认是 ~/Szamlak/{cégnév}/ 保存到文件夹（Windows: C:\Users\FELHASZNÁLÓNÉV\Szamlak\{cégnév}\).

安全

  • 配置文件（companies.json) 0600 创建权限（只能由所有者阅读）
  • API密钥被错误消息过滤
  • 所有文件操作的路径穿越保护
  • API调用时的Fetch timeout（30s）
  • 输入验证（日期格式，电子邮件，数组大小）
  • API通信仅通过HTTPS进行

代理 API

这个服务器是 代理 API使用。您可以在设置菜单中在您的帐户中生成API密钥。

来源 ： 每小时最多可创建100个账户。

许可证

国际学生委员会

相关 MCP