发票管理服务器

NAV在线账户MCP服务器

MCP（模型上下文协议）服务器，用于NAV在线账户API v3.0。

该服务器允许AI助理（例如Claude）通过NAV在线账户系统查询和管理账户。

远程使用 （connectors.hu）

如果您不想在本地安装，则 连接器.hu 为您的NAV在线账户（以及其他商业API）提供统一的访问点。connectors.hu 管理身份验证和 nav_* 为您的AI代理提供namespacelt工具（Claude Code，Claude Desktop等）。

登录 connectors.hu

功能

查询工具（只读）

• 查询纳税人 根据税号查询税务信息
• 查询_语音_数据 - 根据帐号查询帐户详细信息
• query_invoice_digest - 使用过滤器搜索帐户（日期，合作伙伴，类别等）
• query_invoice_check 检查系统中的帐户是否存在
• 查询_语音_中文摘要 查看账户修改链
• query_transaction_status - 检查提交的发票处理状态
• query_transaction_list 按日期范围列出交易

写作工具

• manage_invoice 提交账户（CREATE，MODIFY，STORNO）
• 管理_取消 帐户的技术取消

前提条件

NAV在线帐户需要技术用户。注册：

• 测试: https://onlineszamla-test.nav.gov.hu/
• 埃尔斯: https://onlineszamla.nav.gov.hu/

本地安装

如果您想在本地运行服务器：

1. 安装

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

2. 配置

第二个是 .env.example 文件 .env 请填写您的姓名：

cp .env.example .env

需要的环境变量：

3. 添加到 Claude Code

添加到 ~/.claude/settings.json 到文件 ：

{
  "mcpServers": {
    "nav-online-invoice": {
      "command": "node",
      "args": ["/elérési/út/nav-online-invoice-mcp/dist/cli.js"],
      "env": {
        "NAV_LOGIN": "felhasználónév",
        "NAV_PASSWORD": "jelszó",
        "NAV_TAX_NUMBER": "12345678",
        "NAV_SIGNATURE_KEY": "aláíró_kulcs",
        "NAV_EXCHANGE_KEY": "cserekulcs",
        "NAV_ENV": "production"
      }
    }
  }
}

应用范例

配置后，您可以询问 Claude：

• “查找此税号：12345678”
• “列出2024年1月发行的账户”
• “询问INV-001账户详情”
• “此交易的处理状态是什么： TX123”

API参考

这个服务器是 NAV在线发票API v3.0 实施。

验证

所有请求都会自动使用 SHA-512（密码）和 SHA3-512（请求签名）进行签名。代币交换在写作操作中自动进行。

环境

支持

如果你觉得这个项目有用，你可以支持它：

NAV在线发票MCP服务器（英文）

匈牙利NAV在线发票（Online Számla）API v3.0的MCP（模型上下文协议）服务器。

该服务器允许像克劳德这样的人工智能助手通过NAV在线发票系统查询和管理发票。

远程使用（连接器.hu）

如果你不想在本地安装， 连接器.hu 为NAV Online Számla（和其他匈牙利商业API）提供了一个统一的接入点。connectors.hu处理身份验证并公开 nav_* 将命名空间工具添加到您的AI代理（Claude Code、Claude Desktop等）。

通过连接器连接。hu

特性

查询工具（只读）

• 查询纳税人 -按税号查找纳税人信息
• 查询_语音_数据 -按发票编号获取完整的发票详细信息
• query_invoice_digest -使用过滤器（日期、合作伙伴、类别等）搜索发票
• query_invoice_check -检查系统中是否存在发票
• 查询_语音_中文摘要 -查看发票的修改链
• query_transaction_status -检查已提交发票的处理状态
• query_transaction_list -列出日期范围内的交易

写入工具

• manage_invoice -提交发票（创建、修改、存储）
• 管理_取消 -发票的技术废止

先决条件

您需要一个NAV在线发票技术用户。注册地址：

• 测试: https://onlineszamla-test.nav.gov.hu/
• 生产: https://onlineszamla.nav.gov.hu/

本地安装

如果您更喜欢在本地运行服务器：

1.安装

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

2.配置

复制 .env.example 到 .env 并填写您的凭据：

cp .env.example .env

所需的环境变量：

3.添加到克劳德代码

添加到您的 ~/.claude/settings.json:

{
  "mcpServers": {
    "nav-online-invoice": {
      "command": "node",
      "args": ["/path/to/nav-online-invoice-mcp/dist/cli.js"],
      "env": {
        "NAV_LOGIN": "your_login",
        "NAV_PASSWORD": "your_password",
        "NAV_TAX_NUMBER": "12345678",
        "NAV_SIGNATURE_KEY": "your_signature_key",
        "NAV_EXCHANGE_KEY": "your_exchange_key",
        "NAV_ENV": "production"
      }
    }
  }
}

使用示例

配置后，您可以询问Claude：

• “查找此税号：12345678”
• “列出2024年1月开具的发票”
• “获取发票INV-001的详细信息”
• “交易TX123的处理状态如何”

api参考

此服务器实现 NAV在线发票API v3.0.

认证

所有请求都使用SHA-512（密码）和SHA3-512（请求签名）自动签名。写操作的令牌交换是自动处理的。

环境

支持

如果你觉得这个项目有用，你可以支持开发：

许可证

麻省理工学院