Papierkram MCP服务器
  
一 主控程序 （模型上下文协议）服务器 纸带de 会计API。使AI助手能够管理发票、费用、联系人、项目、时间跟踪，并更直接地在您的Papierkram帐户中管理。
特性
- 56工具 涵盖整个Papierkram API v1
- 两次运输：stdio（用于克劳德桌面、光标、克劳德代码）和HTTP/SSE（用于n8n，自定义集成）
- Docker就绪 便于自托管部署
- 对所有参数进行Zod模式验证的TypeScript
工具概述
| 区域 | 操作 | 计数 |
|---|---|---|
| 联系人 | 公司和联系人：列表、获取、创建、更新、删除 | 10 |
| 发票 | 列表、获取、创建、更新、删除、取消、存档、发送、下载PDF | 9 |
| 估计 | 列表、获取、创建、更新、删除、发送、下载PDF | 7 |
| 开支 | 列表、获取、创建、更新、删除 | 5 |
| 项目 | 列表、获取、创建、更新、删除、存档、取消存档 | 7 |
| 时间追踪 | 列表、获取、创建、更新、删除 | 5 |
| 任务 | 列表、获取、创建、更新、删除 | 5 |
| 银行业 | 列表，获取银行连接和交易记录（只读） | 4 |
| 账户 | 账户信息、付款条件、建议 | 4 |
快速开始
先决条件
- 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 -dHTTP/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服务