Heu MCP

Name: Heu MCP
Author: lucavisconti211-debug

作者：lucavisconti211-debug版本 0.1.2i★ –i在你的电脑上运行

注册名称io.github.lucavisconti211-debug/heu-mcp

安装

概览

作者提供的说明（英文原文）

HEU Legal e-signature MCP: manage HEU documents and PDFs, prompt signers, download PDFs.

PopNx MCP 的三大支柱

这三项永远不会合并成一个分数：意见、测量和人气是不同的东西。

用户评价i暂无评价评价功能将在后续阶段与账户功能一起开放
我们的基础检查i1 项中通过 1 项依据公开信息检查；尚未扫描代码
使用情况i非常新↓ 35/周 · ★ –

它能帮你做什么

我们还没有为它写通俗的介绍。下面是我们从注册中心读取到的事实。

连接方式: 在你的电脑上运行
传输方式: stdio
分类: 文档、表格与办公
你需要填写：HEU_API_KEY

安装

选择你使用的 AI 应用，然后复制设置。

安装之前

基础检查：1 项中通过 1 项
在你的电脑上运行，拥有你的用户账户的权限（文件、网络、应用）。
需要你自己填写： HEU_API_KEY, HEU_BASE_URL, HEU_DOWNLOAD_DIR

标为机密的值是你账户的钥匙。千万不要分享给别人，也不要粘贴到聊天里。

你需要

PyPI已安装 Python 的 uv（用于 uvx 命令）

你用的是哪个应用？

ClaudeClaude CodeCursorVS CodeChatGPT

在上方选择你的应用。我们会记住它，下次按钮会显示“安装到 …”。

打开 Claude Desktop → Settings → Developer → Edit Config，把下面的内容粘贴到 claude_desktop_config.json

{
  "mcpServers": {
    "heu": {
      "command": "uvx",
      "args": [
        "heu-mcp"
      ],
      "env": {
        "HEU_API_KEY": "your-value",
        "HEU_BASE_URL": "your-value",
        "HEU_DOWNLOAD_DIR": "your-value"
      }
    }
  }
}

在终端中运行这条命令

claude mcp add heu --env HEU_API_KEY=your-value --env HEU_BASE_URL=your-value --env HEU_DOWNLOAD_DIR=your-value -- uvx heu-mcp

运行前请先填写空着的值。

在 Cursor 中打开

或者自己复制设置

粘贴到项目中的 .cursor/mcp.json，或 ~/.cursor/mcp.json

{
  "mcpServers": {
    "heu": {
      "command": "uvx",
      "args": [
        "heu-mcp"
      ],
      "env": {
        "HEU_API_KEY": "your-value",
        "HEU_BASE_URL": "your-value",
        "HEU_DOWNLOAD_DIR": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

在 VS Code 中打开

或者自己复制设置

粘贴到项目中的 .vscode/mcp.json

{
  "servers": {
    "heu": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "heu-mcp"
      ],
      "env": {
        "HEU_API_KEY": "your-value",
        "HEU_BASE_URL": "your-value",
        "HEU_DOWNLOAD_DIR": "your-value"
      }
    }
  }
}

浏览器会先询问是否打开应用，然后应用会显示设置并请你确认。密钥的值会留空，由你自己填写。

这个服务器在你的电脑上运行，而 ChatGPT 只能连接互联网上的服务器。请选择其他应用。

你的选择通过 Cookie 保存在这台设备上，无需账户。

需要你填写的值

HEU_API_KEY 机密必填 env
HEU Legal API key (Profile > API Keys, Enterprise plan required)
HEU_BASE_URL env
API base URL. Default: https://api.heulegal.com/v1
HEU_DOWNLOAD_DIR env
Directory where downloaded PDFs are saved. Default: /tmp

这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同，请以 README 为准。

它能做什么

它在你的电脑上运行；安装后，工具列表会显示在你的 AI 应用中。

基础检查i

我们检查的是任何人都能看到的信息；我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月8日

✓ 通过
作者与仓库一致
注册名称已通过 GitHub 账户 lucavisconti211-debug 验证，该账户拥有此仓库
… 尚未检查
仍在维护
我们还没有从 GitHub 读取这个仓库
… 尚未检查
有许可证
我们还没有从 GitHub 读取这个仓库
– 不适用
端点有响应
它在你的电脑上运行，没有互联网端点
– 不适用
使用 OAuth 登录
在你的电脑上运行，改用本地设置
… 尚未检查
工具描述中没有隐藏指令
它在你的电脑上运行；我们只能读取互联网端点的工具列表

与“文档、表格与办公”中的其他服务器比较i

星标数多于此分类中其他 3572 个服务器的 0%
发布到注册中心的时间比此分类中其他 3572 个服务器的 9% 更新
基础检查结果等于或优于此分类中其他 3572 个服务器的 100%

与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时，星标数才计入。

常见问题

Heu MCP 安全吗？

它在 1 项适用的基础检查中通过了 1 项。我们没有阅读代码。在添加密钥或令牌之前，请先看看这个服务器要求哪些权限，并使用只具备所需权限的密钥。

它需要哪些密钥或代码？

你需要填写：HEU_API_KEY

它在我的电脑上运行还是在云端？

它在你的电脑上运行。你的 AI 应用会在需要时启动它，数据不会经过作者的服务器（除非它自己调用在线服务）。

它还在维护吗？

GitHub 仓库最后更新于–，最新版本（0.1.2）于6个月前进入注册中心。

哪些应用可以使用它？

支持 MCP 的应用，例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Python (uv)。

有什么可以替代它？

同一分类中有：Agent-Native Calendar, Excel MCP Server, MCP Server for Excel

替代选择

同一分类中其他作者的服务器，按星标数排序。

如何看卡片：↓ 每周下载量i★ GitHub 星标i三大支柱：评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i

Agent-Native Calendar

Agent-Native Google Calendar - manage events, sync, and public booking

作者：BuilderIO正在增长★ 76202个月前更新

在云端运行

安装

Excel MCP Server

Create and edit Excel files with AI: charts, PivotTables, formulas. No Excel needed.

作者：haris-musa广泛使用↓ 5万/周★ 42767天前更新

在你的电脑上运行

安装

MCP Server for Excel

Excel automation for AI - Sheets, Power Query, DAX, VBA, Tables, Ranges and more. Windows only.

作者：sbroenne正在增长↓ 4321/周★ 8475天前更新

在你的电脑上运行

安装

作者的 README

打开 README

按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。

HEU Legal MCP Server

MCP server (Model Context Protocol) che collega l'API HEU Legal a Claude e a qualsiasi client MCP. Gestisce l'intero ciclo di vita dei documenti con firma elettronica (valida in 180+ paesi) direttamente in conversazione: dalla creazione all'invio in firma, dal sollecito al download del fascicolo legale completo.

Cosa puoi fare

Voglio...	Il server lo fa con...
📄 Vedere i miei documenti e templates	`list_heu_documents`, `list_pdf_documents`
✍️ Mandare un contratto in firma da un template	`create_heu_document`, `create_pdf_document`
🚀 Mandare in firma un PDF che ho sul computer, senza passare dalla piattaforma	`create_pdf_document_from_upload`
🤖 Far mappare i campi firma all'AI (analizza il PDF, posiziona i campi, invia)	`locate_pdf_text` + `create_pdf_document_from_upload`
🔔 Sollecitare chi non ha ancora firmato	`prompt_heu_document_signature`, `prompt_pdf_document_signature`
👀 Far leggere un contratto all'AI (riassunti, clausole, confronti) senza scaricarlo	`read_heu_document`, `read_pdf_document`
🪪 Estrarre i dati delle parti (P.IVA, codice fiscale, SDI, PEC, indirizzi)	`extract_heu_document_parties`, `extract_pdf_document_parties`
💾 Scaricare il PDF firmato	`download_heu_document_pdf`, `download_pdf_document`
⚖️ Scaricare il fascicolo legale completo (documento + audit trail + artefatti FES)	`download_pdf_bundle`, `download_pdf_audit_trail`
🧩 Creare/modificare templates PDF riutilizzabili via API	`create_pdf_template`, `update_pdf_template`, `preview_pdf_template`, `delete_pdf_template`
❌ Annullare una richiesta di firma inviata per errore	`cancel_pdf_document`
🩺 Controllare che l'API sia raggiungibile	`get_heu_health`

Due famiglie di oggetti:

Documenti nativi HEU — creati con l'editor in-app della piattaforma (ID a forma di UUID, es. 5135e7b2-196b-...).
PDF caricati — file PDF con firmatari e campi firma posizionati sopra (ID numerici, es. 68).

Requisiti

Python ≥ 3.10
API key HEU Legal — nella UI: Profile → API Keys → Generate API Key (richiede subscription Enterprise; massimo 2 chiavi attive)
Per i flussi da template: almeno un template creato sulla piattaforma (oppure crealo via API con create_pdf_template)

Installazione

Da PyPI:

pip install heu-mcp

Da sorgenti:

git clone https://github.com/heulegal/heu-mcp.git

cd heu-mcp python3 -m venv venv source venv/bin/activate pip install -r requirements.txt

Configurazione

Claude Desktop

Modifica ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

"mcpServers": { "heu": { "command": "heu-mcp", "args": [], "env": { "HEU_API_KEY": "la_tua_api_key_qui" } } } }

Se installato da sorgenti con venv:

"mcpServers": { "heu": { "command": "/path/assoluto/heu-mcp/venv/bin/python", "args": ["/path/assoluto/heu-mcp/server.py"], "env": { "HEU_API_KEY": "la_tua_api_key_qui" } } } }

Riavvia Claude Desktop dopo la modifica.

Claude Code (CLI)

claude mcp add heu heu-mcp -e HEU_API_KEY=la_tua_api_key_qui

Server remoto (multi-utente)

Oltre alla modalità locale (stdio) descritta sopra, il progetto include un server remoto che espone gli stessi 28 tool via HTTPS, così gli utenti si collegano senza installare nulla: inseriscono la propria API key HEU una volta, in un flusso OAuth.

Caratteristiche:

Transport Streamable HTTP, autenticazione OAuth 2.1 con PKCE S256, Dynamic Client Registration e Client ID Metadata Document
Multi-utente: ogni connessione usa la API key del proprio utente, conservata cifrata (Fernet) e mai in chiaro nel database
Refresh token con rotazione e revoca automatica della sessione in caso di riuso sospetto
I/O di rete asincrono e parsing PDF su threadpool: una richiesta lenta non blocca gli altri utenti

Avvio locale

pip install -e ".[remote]"

export HEU_MCP_SECRET_KEY="$(python -c 'from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())')" export PUBLIC_URL="http://localhost:8080" export HEU_MCP_DB="./heu-mcp.db" heu-mcp-remote

Deploy su Fly.io

fly launch --no-deploy

fly volumes create heu_data --size 1 fly secrets set HEU_MCP_SECRET_KEY="$(python -c 'from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())')" fly secrets set PUBLIC_URL="https:// .fly.dev" fly deploy

Variabili d'ambiente del server remoto

Variabile	Descrizione	Default
`HEU_MCP_SECRET_KEY`	Chiave Fernet per cifrare le API key degli utenti (richiesta)	—
`PUBLIC_URL`	URL pubblico del servizio, senza slash finale (richiesta in produzione)	`http://localhost:8080`
`MCP_PATH`	Path dell'endpoint MCP	`/mcp`
`HEU_MCP_DB`	Percorso del database SQLite	`/data/heu-mcp.db`
`ACCESS_TOKEN_TTL` / `REFRESH_TOKEN_TTL`	Durata token in secondi	1 ora / 60 giorni

Endpoint esposti

Endpoint	Scopo
`/mcp`	Endpoint MCP (richiede bearer token)
`/.well-known/oauth-protected-resource`	Metadati risorsa protetta (RFC 9728)
`/.well-known/oauth-authorization-server`	Metadati authorization server (RFC 8414)
`/register` · `/authorize` · `/token`	Flusso OAuth 2.1
`/healthz`	Liveness probe

Variabili d'ambiente

Variabile	Descrizione	Default
`HEU_API_KEY`	API key HEU Legal (richiesta)	—
`HEU_BASE_URL`	URL base dell'API	`https://api.heulegal.com/v1`
`HEU_DOWNLOAD_DIR`	Cartella dove salvare i file scaricati	`/tmp`

Riferimento completo dei tool (28)

🩺 Health

Tool	Parametri	Cosa ritorna
`get_heu_health`	—	`{ message: "ok", status: 200 }` se l'API è operativa

📄 Documenti nativi HEU

Tool	Parametri	Cosa fa
`list_heu_documents`	`type` (document/template), `sort` (asc/desc), `created_from` + `created_to` (ISO 8601), `have_editors_signed` — tutti opzionali	Lista documenti/template con stato, membri, firme. ⚠️ Le due date vanno passate sempre insieme, altrimenti l'API può restituire risultati incompleti
`get_heu_document`	`document_id`	Dettaglio completo: nome, stato (`to_sign`/`in_progress`/`in_review`/`completed`/`signed`), owner, editors, members con `has_signed` e `signed_at`, tags
`list_heu_document_placeholders`	`document_id`	Elenco delle chiavi placeholder sostituibili nel testo del template
`create_heu_document` ✋	`source_document_id`, `email_subject`, `email_text`, `email_to` (lista), `document_name`, `document_type`, `placeholders` (mappa chiave→valore)	Crea un documento da un template, sostituisce i placeholder e lo condivide via email ai destinatari
`prompt_heu_document_signature` ✋	`document_id`	Invia il sollecito di firma. Limite: 1 ogni 24h per documento (429 con `Retry-After` se superato)
`read_heu_document`	`document_id`, `pages` (es. `"1-3"`, `"5"`, `"1,3,5-7"`), `layout`, `has_index`, `has_footer`	Estrae il testo del documento e lo restituisce in conversazione, senza salvare nulla su disco. Max 100 pagine se `pages` è omesso
`extract_heu_document_parties`	`document_id`, `pages`, `include_text`	Dati delle parti: combina i firmatari registrati con l'estrazione dal testo di codici fiscali, P.IVA, codice univoco SDI, email, PEC, luogo+data di nascita, indirizzi, CAP. Pattern ottimizzati per contratti italiani
`download_heu_document_pdf`	`document_id`, `layout` (codici UI: 100, 200-204, 210-214, 220-224, 230-234), `has_index`, `has_footer`, `output_path`	Genera e salva il PDF su disco; ritorna il path

📎 PDF caricati

Tool	Parametri	Cosa fa
`list_pdf_documents`	`type` (richiesto: document/template), `sort`	Lista PDF con stato (`to_sign`/`in_progress`/`signed`), tipo firma (FES/FEA), firmatari
`get_pdf_document`	`document_id`	Dettaglio: nome, stato, `signature_type`, date, firmatari con `has_read`/`has_signed`
`list_pdf_document_signers`	`document_id`	Firmatari del PDF: id, nome, email, ha letto, ha firmato
`list_pdf_document_signer_placeholders`	`document_id`, `signer_id`	Campi (firma/testo/checkbox) assegnati a un firmatario specifico, con posizione e stato di compilazione
`list_pdf_document_placeholders`	`document_id`	Tutti i campi del PDF
`create_pdf_document` ✋	`source_document_id`, `email_subject`, `email_body`, `signers` (con `source_id`, `full_name`, `email`), `document_name`, `signature_type` (fes/fea), `placeholders` precompilabili	Crea un PDF firmabile da un template esistente e invia gli inviti. Con `fea` servono crediti sufficienti (422 altrimenti)
`prompt_pdf_document_signature` ✋	`document_id`	Sollecito di firma per il PDF
`read_pdf_document`	`document_id`, `pages`	Estrae il testo del PDF (incluso quello firmato) e lo restituisce in conversazione
`extract_pdf_document_parties`	`document_id`, `pages`, `include_text`	Dati delle parti (come sopra) per i PDF caricati
`download_pdf_document`	`document_id`, `output_path`	Scarica il PDF — versione firmata se disponibile — e ritorna il path
`download_pdf_audit_trail`	`document_id`, `output_path`	Scarica l'audit trail: il registro PDF di chi ha letto/firmato e quando
`download_pdf_bundle`	`document_id`, `output_path`	Scarica lo ZIP del fascicolo legale: PDF firmato + audit trail + artefatti FES. Ideale per archiviazione a valore probatorio
`cancel_pdf_document` ✋	`document_id`	Annulla una richiesta di firma inviata: il documento sparisce dagli elenchi e i link di firma vengono invalidati. Rifiutato con 409 se qualcuno ha già firmato

🧩 Template PDF (gestione via API)

Tool	Parametri	Cosa fa
`create_pdf_template` ✋	`file_path` (PDF locale ≤ 5 MB), `document_name`, `signers` (`source_id`, `full_name`), `placeholders` (tipo, posizione %, pagina)	Crea un template riutilizzabile caricando un PDF dal computer. L'ID restituito si usa come `source_document_id` in `create_pdf_document`
`create_pdf_document_from_upload` ✋	`file_path`, `document_name`, `email_subject`, `email_body`, `signers` (con email), `placeholders`, `signature_type`	Scorciatoia completa: carica un PDF e lo manda subito in firma, senza creare prima il template. Il documento nasce `to_sign` e i firmatari ricevono l'email immediatamente
`locate_pdf_text`	`file_path` oppure `document_id`, `search_terms` (default: parole chiave firma), `pages`, `include_all_lines`	Trova le coordinate di testi nel PDF (in %, origine in basso a sinistra — lo stesso sistema dei placeholder). È il tool che permette all'AI di posizionare i campi da sola: cerca "Firma", i nomi delle parti o qualsiasi ancora, e ottiene pagina + posizione di ognuna
`preview_pdf_template`	`document_id`, `output_path`	Scarica un'anteprima annotata: ogni campo è disegnato come riquadro etichettato con tipo e firmatario. Per verificare le posizioni prima dell'invio

| update_pdf_template ✋ | document_id, signers (set completo sostitutivo), placeholders (idem; [] li ca

只显示了开头部分；其余内容请在仓库中阅读