Papierkram MCP Server

Papierkram MCP服务器

一 主控程序 （模型上下文协议）服务器 纸带de 会计API。使AI助手能够管理发票、费用、联系人、项目、时间跟踪，并更直接地在您的Papierkram帐户中管理。

特性

• 56工具 涵盖整个Papierkram API v1
• 两次运输：stdio（用于克劳德桌面、光标、克劳德代码）和HTTP/SSE（用于n8n，自定义集成）
• Docker就绪 便于自托管部署
• 对所有参数进行Zod模式验证的TypeScript

工具概述

快速开始

先决条件

• 18+（或Docker）
• A. 纸带de 具有API访问权限的帐户

获取API密钥

首选 文档框 > 设置 > API 并创建API密钥。

选项A:Docker（推荐）

git clone https://github.com/Wagner-Emden-IT-Services/papierkram-mcp-server.git
cd papierkram-mcp-server
cp .env.example .env
# Edit .env with your API key and subdomain
docker compose up -d

HTTP/SSE服务器将在 http://localhost:3001/sse.

选项B：Node.js

git clone https://github.com/Wagner-Emden-IT-Services/papierkram-mcp-server.git
cd papierkram-mcp-server
npm install
cp .env.example .env
# Edit .env with your API key and subdomain
npm run build

配置

创建一个 .env 文件（或复制自 .env.example):

PAPIERKRAM_API_KEY=your-api-key-here
PAPIERKRAM_SUBDOMAIN=your-subdomain
PORT=3001  # optional, only for HTTP/SSE mode

您的子域是前面的部分 .papierkram.de 在您的Papierkram URL中。

用法

克劳德桌面版

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "papierkram": {
      "command": "node",
      "args": ["/absolute/path/to/papierkram-mcp-server/dist/index.js"],
      "env": {
        "PAPIERKRAM_API_KEY": "your-api-key",
        "PAPIERKRAM_SUBDOMAIN": "your-subdomain"
      }
    }
  }
}

克劳德代码（CLI）

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

{
  "mcpServers": {
    "papierkram": {
      "command": "node",
      "args": ["/absolute/path/to/papierkram-mcp-server/dist/index.js"],
      "env": {
        "PAPIERKRAM_API_KEY": "your-api-key",
        "PAPIERKRAM_SUBDOMAIN": "your-subdomain"
      }
    }
  }
}

光标

使用与Claude Desktop相同的配置添加到您的光标MCP设置中。

HTTP/SSE（适用于n8n或自定义客户端）

# Development
npm run dev:http

# Production
npm run start:http

# Docker
docker compose up -d

将您的MCP客户端连接到 http://localhost:3001/sse.

发展

npm run dev        # stdio mode with hot reload
npm run dev:http   # HTTP/SSE mode with hot reload
npm run build      # compile TypeScript to dist/

项目结构

src/
├── index.ts              # Stdio entry point
├── server/
│   ├── server.ts         # MCP server setup + tool registration
│   └── http-server.ts    # HTTP/SSE entry point
├── core/tools/           # Tool definitions (one file per API area)
├── api/
│   ├── client.ts         # HTTP client with auth & error handling
│   └── types.ts          # TypeScript types
└── config/
    └── index.ts          # Environment configuration

贡献

欢迎投稿！请打开问题或拉取请求。

许可证

麻省理工学院 -Wagner Emden IT服务