Lexware Office MCP 服务器

一个集成Lexware Office（前称为Lexoffice）的MCP服务器实现，通过模型上下文协议提供无缝接口，用于管理企业业务操作。

功能特点

• Lexware Office 集成：直接与Lexware Office API集成
• 企业管理：管理发票、联系人和其他业务文档（目前为只读）

工具

以下工具可通过此MCP服务器使用：

• get-invoices

  • 获取Lexware Office中的发票列表
  • 输入参数：
    • status (字符串数组，可选)：按状态过滤（"open", "draft", "paid", "paidoff", "voided"）。默认：所有状态
    • page (数字，可选)：要获取的页码（从0开始）。默认：0
    • size (数字，可选)：每页显示的发票数量（1-250）。默认：250

• get-invoice-details

  • 获取Lexware Office中某个发票的详细信息
  • 输入参数：
    • id (字符串)：发票的UUID

• get-contacts

  • 按条件获取Lexware Office中的联系人，支持逻辑与的多个过滤器
  • 输入参数：
    • email (字符串，可选)：按电子邮件地址过滤（支持通配符）
    • name (字符串，可选)：按名称过滤（支持通配符）
    • number (数字，可选)：按联系人编号过滤
    • customer (布尔值，可选)：按客户角色过滤
    • vendor (布尔值，可选)：按供应商角色过滤
    • page (数字，可选)：要获取的页码（从0开始）。默认：0
    • size (数字，可选)：每页显示的联系人数量（1-250）。默认：250

• list-posting-categories

  • 获取会计凭证使用的分录类别的列表
  • 输入参数：
    • type (字符串，可选)：按类别类型过滤（"income" 或 "outgo"）

• list-countries

  • 获取Lexware Office中已知的国家及其税收分类信息
  • 输入参数：
    • taxClassification (字符串，可选)：按税收分类过滤（"de" 表示德国，"intraCommunity" 表示欧盟国家，或 "thirdPartyCountry" 表示非欧盟国家）

配置说明

获取Lexware Office API密钥

访问 https://app.lexoffice.de/addons/public-api 以获取您的API密钥。

先决条件

• Node.js 22或更高版本

使用Claude Desktop

将以下内容添加到 claude_desktop_config.json 文件中：

{
	"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"
			}
		}
	}
}

项目构建

要构建此项目，请运行以下命令：

npm install

构建说明

• 项目依赖于Node.js环境。
• 确保安装所有所需的依赖项。

许可证信息

请参考项目的LICENSE文件以获取许可详细信息。