Lexware Office MCP Server

与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获取联系人，带有可选过滤器，这些过滤器通过逻辑AND组合
  • 输入参数：
    • 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中添加以下内容：

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

构建

Docker构建：

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

许可证

本项目根据MIT许可证发布。请参阅项目存储库中的LICENSE文件以获取详细信息。 </中文翻译>