AI导哈

电子发票服务

mcp-einvoice是一个用于法国电子发票计费的MCP服务器，提供统一的接口支持所有认证平台（PA），并可由任何AI代理使用。

  • by Casys-AI
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 Casys-AI/mcp-einvoice

使用说明

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

只有活动平台支持的工具公开给代理。 添加平台→

获取沙盒帐户

我们能做什么

39工具

类别 示例
发票 （11） 搜索、查看、提交、下载、生成（CII/UBL/FACTUR-X）
目录 （3）FR研究（SIRET/SIREN）、国际研究、PEPPOL验证
法规 （2）生命周期历史记录、发送状态（接受、拒绝、支付）
报告 （2）电子交易报告
网络钩子 （5） Webhook上的完整CRUD
配置 （16）实体、标识符、网络和注册的管理

6个互动观众

查看器 用法
发票查看器 详细发票+行动（接受、拒绝、归档）
文档列表查看器 带向下钻、方向/状态过滤器的表
状态时间线 状态更改的垂直时间线
目录卡 公司简介（Siren/Siret、网络）
目录列表 带有客户端搜索的目录结果
行动结果 视觉行动反馈

工作流制作

  1. generate_* →在查看器中预览发票
  2. 目视检查+按钮“存款”
  3. submit →发送到平台

REST API

deno task rest:serve     # Port 3016
  • Swagger用户界面 http://localhost:3016/docs
  • 通过验证 X-API-Key （环境 EINVOICE_REST_API_KEY, --no-auth en dev）
  • 与MCP服务器相同的适配器层

包裹

Monorepo Deno包含3个软件包，发布于 日本合成橡胶 和 npm :

包 角色
@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 商店

完整指南： packages/core/src/adapters/GUIDE.md

相关 MCP