Lexware Office MCP Server

Lexware Office MCP Server

site icon
2025.03.17 2
TypeScript企业财务管理发票管理联系人管理会计凭证分类管理国家税务分类查询金融服务
Lexware Office MCP Server 是一个与 Lexware Office(原 Lexoffice)集成的 MCP 服务器实现,通过 Model Context Protocol 提供无缝的接口来管理业务操作。 **核心功能**: - Lexware Office 集成:直接与 Lexware Office API 集成 - 业务操作:管理发票、联系人和其他业务文档(目前为只读) **适用场景**: - 企业财务管理 - 发票管理 - 联系人管理 - 会计凭证分类管理 - 国家税务分类查询
View on GitHub

Overview

基本能力

核心功能

  • Lexware Office 集成:直接与 Lexware Office API 集成
  • 业务操作:管理发票、联系人和其他业务文档(目前为只读)

工具列表

  • get-invoices
  • 从 Lexware Office 获取发票列表
  • 支持按状态、页码和每页数量过滤

  • get-invoice-details

  • 获取 Lexware Office 中特定发票的详细信息
  • 需要提供发票的 UUID

  • get-contacts

  • 从 Lexware Office 获取联系人列表
  • 支持按电子邮件、姓名、号码、客户/供应商角色等多条件过滤

  • list-posting-categories

  • 获取会计凭证的分类列表
  • 支持按类型(收入/支出)过滤

  • list-countries

  • 获取 Lexware Office 已知的国家及其税务分类
  • 支持按税务分类(德国、欧盟国家或非欧盟国家)过滤

常见问题

  • 目前所有业务操作均为只读模式
  • 需要有效的 Lexware Office API 密钥才能使用

使用教程

使用依赖

  • Node.js 22 或更高版本

安装教程

Docker 方式

docker build -t mcp-lexware-office:latest -f Dockerfile .

NPX 方式

npx -y JannikWempe/mcp-lexware-office

配置

  1. 获取 Lexware Office API 密钥:https://app.lexoffice.de/addons/public-api
  2. 在 Claude Desktop 配置中添加以下内容:

Docker 配置

{
    "mcpServers": {
        "mcp-lexware-office": {
            "command": "docker",
            "args": ["run", "-i", "--rm", "-e", "LEXWARE_OFFICE_API_KEY", "mcp-lexware-office"],
            "env": {
                "LEXWARE_OFFICE_API_KEY": "YOUR_API_KEY_HERE"
            }
        }
    }
}

NPX 配置

{
    "mcpServers": {
        "mcp-lexware-office": {
            "command": "npx",
            "args": ["-y", "JannikWempe/mcp-lexware-office"],
            "env": {
                "LEXWARE_OFFICE_API_KEY": "YOUR_API_KEY_HERE"
            }
        }
    }
}

调试方式

  • 确保环境变量 LEXWARE_OFFICE_API_KEY 已正确设置
  • 检查 Node.js 版本是否符合要求
  • 使用各工具的命令行参数进行测试

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。