lexware

lexware-mcp-server

用于 Lexware Office API 的 MCP 服务。通过模型上下文协议管理发票、联系人、商品、凭证等内容。

非官方社区项目——与 Lexware GmbH 或 Haufe Group 无关联。请参阅免责声明。

要求

• Node.js 20 或更高版本。
• 从 Lexware Office API 设置获取的 Lexware Office API 令牌。

快速开始

1. 将令牌存储在操作系统密钥环中

服务会优先从操作系统密钥环（服务 lexware-mcp，账户 api-token）读取令牌，若未找到，则使用 LEXWARE_API_TOKEN 环境变量。建议使用密钥环：这样 MCP 配置中就无需存放任何凭据。

以下命令会提示输入令牌，因此令牌不会留在 shell 历史记录或进程列表中。

macOS：

security add-generic-password -s "lexware-mcp" -a "api-token" -w

Linux（需要 Secret Service / libsecret）：

secret-tool store --label="Lexware Office API" service lexware-mcp username api-token

有关 Windows、无头机器以及环境变量备用方案的信息，请参阅配置指南。

2. 将服务添加到 MCP 客户端

{
  "mcpServers": {
    "lexware": {
      "command": "npx",
      "args": ["-y", "@lazyants/lexware-mcp-server"]
    }
  }
}

将以下内容添加到客户端的 MCP 配置中，例如 Claude Desktop 的 claude_desktop_config.json。在 Claude Code 中运行：

claude mcp add --scope user lexware -- npx -y @lazyants/lexware-mcp-server

npx 会下载并运行此软件包；无需单独安装。重启客户端后，Lexware 工具便会显示在工具列表中。

入口点

此软件包提供完整服务，也提供各自涵盖一个领域的小型拆分服务。使用拆分服务可以缩小上下文，或避免超出 MCP 客户端的工具数量限制。

命令	涵盖内容
lexware-mcp-server	以下所有内容
lexware-mcp-sales	发票、贷项通知单、报价单、订单确认单、送货单、预付款发票、催款单、凭证列表
lexware-mcp-contacts	联系人、商品
lexware-mcp-bookkeeping	凭证、凭证列表、付款
lexware-mcp-reference	国家、付款条件、记账类别、档案、打印版式
lexware-mcp-system	事件订阅、文件、周期性模板

使用 npx -y -p @lazyants/lexware-mcp-server lexware-mcp-sales 运行拆分服务。配置指南提供了拆分服务和多个 Lexware 账户的客户端示例。

工具的功能

工具名称遵循 lexware_<action>_<resource> 格式，例如 lexware_create_invoice 或 lexware_list_voucherlist。这些工具可以创建和读取发票、报价单等销售凭证，管理联系人和商品，记录记账凭证，跨凭证类型搜索，上传和下载文件，以及管理 Webhook 订阅。MCP 客户端的工具列表及每个工具的说明和输入架构，是最权威的工具清单。

每个入口点还会提供只读 MCP 资源 reference://lexware/api，其中包含 API 约定、文本格式规则和 Webhook 指南。

使用指南说明了 API 的注意事项：创建时完成定稿、凭证搜索筛选条件、凭证更新、文件上传与下载，以及 Webhook。

安全性

• 使用 OS 密钥环，切勿将 API 令牌提交到版本控制系统。
• 创建、更新、删除、上传和追进工具会更改 Lexware 账户中的实际业务数据。追进工具会创建一份后续单据。
• 设置 LEXWARE_READ_ONLY=true，让服务拒绝所有会更改数据的工具。请参阅 只读模式。
• 未启用只读模式时，有两项机制可以防止意外更改：Lexware 强制执行的 Lexware API 令牌权限，以及 MCP 客户端的批准提示。readOnlyHint 等工具注解只是给客户端的提示，并非检查机制。
• 拆分服务提供的工具较少，但其中大多数仍包含会更改数据的工具。有关较保守的配置，请参阅 限制服务可更改的内容。
• 达到速率限制的请求（HTTP 429）会自动采用指数退避方式重试。

如需报告漏洞，请参阅 SECURITY.md。

文档

• 配置 — macOS、Windows 和 Linux 的密钥环设置；环境变量；Claude Code 和 Claude Desktop； 拆分服务和多个账户；限制服务可更改的内容。
• 使用说明 — API 行为和注意事项。
• 发布 — 维护者发布流程。
• 更新日志

发布

维护者：请遵循发布指南。 切勿直接使用 gh release create 创建发布；指南中的受保护标签创建流程说明了原因，并可防止重新发布旧版本。

免责声明

这是一个非官方的独立社区项目。本项目与 Lexware GmbH、Haufe Group 或其任何关联公司均无关联，也未获其认可、赞助或支持。如需 Lexware 官方支持，请直接联系 Lexware — 有关此 MCP 服务的问题应在此处报告，而非向 Lexware 报告。

“Lexware”和“Lexware Office”是其各自所有者的商标，在本项目名称和文档中的使用遵循指称性合理使用原则，仅用于标识此客户端连接的第三方 API。

创建、更新和删除操作会更改 Lexware 账户中的实际业务数据。作者按“原样”提供本软件，对因使用本软件而导致的意外更改、数据丢失或任何其他损害概不负责。对生产数据执行写入操作前，请先在沙盒或非关键账户中进行测试。

许可证

FSL-1.1-MIT — 完整条款请参阅 LICENSE。