mcp语音
法国用于电子发票的MCP服务器。独特的界面 适用于所有授权平台(AP),可由任何AI代理使用。
问题
法国的电子发票改革(2026年9月)要求 通过经批准的平台。有106多个,每个都有自己的 API。加入PA需要数周的工作。改变它就是离开 零。
mcp语音 解决方案:一个具有39个工具和6个查看器的MCP服务器 使用模式适配器与任何PA一起工作。
快速启动
# 1. Cloner et configurer
git clone https://github.com/Casys-AI/mcp-einvoice.git
cd mcp-einvoice
cp .env.example .env
# Remplir les credentials de votre PA (voir "Obtenir un compte sandbox")
# 2. Lancer
deno task mcp:serve # Mode HTTP sur localhost:3015连接到Claude桌面(stdio)
{
"mcpServers": {
"einvoice": {
"command": "deno",
"args": ["run", "--allow-all", "packages/mcp/server.ts"],
"env": {
"EINVOICE_ADAPTER": "iopole",
"IOPOLE_API_URL": "https://api.ppd.iopole.fr/v1",
"IOPOLE_CLIENT_ID": "...",
"IOPOLE_CLIENT_SECRET": "...",
"IOPOLE_CUSTOMER_ID": "..."
}
}
}
}替换 EINVOICE_ADAPTER 段落 storecove 或 superpdp 与变量 对应(见 .env.example).
支持的平台
| 平台 | 封面 | 工具 | |
|---|---|---|---|
| Iopole | PA法语,B2B | 39/39 | |
| 商店 | Peppol,40多个国家 | 19/39 | |
| 超级PDP | PA法语,B2B | 20/39 | |
| Chorus Pro | PPF,公共部门 | 6/39 |
只有活动平台支持的工具公开给代理。 添加平台→
获取沙盒帐户
- Iopole —
全覆盖(39/39工具),非常适合入门。 请求沙盒访问→
- 商店 -PEPPOL国际网络
- 超级PDP --法国足球协会
- Chorus Pro 政府PPF,
公共部门。需要曲目帐户+技术帐户Chorus Pro
我们能做什么
39工具
| 类别 | 示例 |
|---|---|
| 发票 (11) | 搜索、查看、提交、下载、生成(CII/UBL/FACTUR-X) |
| 目录 (3)FR研究(SIRET/SIREN)、国际研究、PEPPOL验证 | |
| 法规 (2)生命周期历史记录、发送状态(接受、拒绝、支付) | |
| 报告 (2)电子交易报告 | |
| 网络钩子 (5) | Webhook上的完整CRUD |
| 配置 (16)实体、标识符、网络和注册的管理 |
6个互动观众
| 查看器 | 用法 |
|---|---|
| 发票查看器 | 详细发票+行动(接受、拒绝、归档) |
| 文档列表查看器 | 带向下钻、方向/状态过滤器的表 |
| 状态时间线 | 状态更改的垂直时间线 |
| 目录卡 | 公司简介(Siren/Siret、网络) |
| 目录列表 | 带有客户端搜索的目录结果 |
| 行动结果 | 视觉行动反馈 |
工作流制作
generate_*→在查看器中预览发票- 目视检查+按钮“存款”
submit→发送到平台
REST API
deno task rest:serve # Port 3016- Swagger用户界面
http://localhost:3016/docs - 通过验证
X-API-Key(环境EINVOICE_REST_API_KEY,--no-authen dev) - 与MCP服务器相同的适配器层
包裹
Monorepo Deno包含3个软件包,发布于 日本合成橡胶 和 :
| 包 | 角色 |
|---|---|
@casys/einvoice-core | 适配器、类型、共享实用程序 |
@casys/mcp-einvoice | Serveur MCP——工具+查看器 |
@casys/einvoice-rest | REST API Hono |
# Deno / JSR
deno add jsr:@casys/mcp-einvoice
# Node / npm
npm install @casys/mcp-einvoice命令
deno task mcp:serve # MCP HTTP (port 3015)
deno task rest:serve # REST API (port 3016)
deno task test # Tous les tests
deno task inspect # MCP Inspector服务器选项: --http, --port=N, --adapter=name, --categories=csv
添加平台
提供了模板、测试合同和指南,以集成 新宾夕法尼亚州:
cp -r packages/core/src/adapters/template/ packages/core/src/adapters/ma-pa/
# Implémenter client.ts + adapter.ts, puis valider :
deno test # runAdapterContract() vérifie les shapes automatiquement| CAS | 基类 | 示例 |
|---|---|---|
| PA法语与AFNOR | AfnorBaseAdapter | 超级PDP |
| PA法语无AFNOR | BaseAdapter | Iopole |
PPF政府 BaseAdapter | Chorus Pro | |
| 非法语平台 | BaseAdapter 商店 |
完整指南:
