内容
# MCP 增值税发票 🇧🇷
MCP 服务器用于巴西电子增值税发票（NF-e, NFC-e, NFS-e）。
将您的 AI 助手连接到巴西增值税发票系统。查询 CNPJ、发出发票、取消、生成 DANFE 的 PDF — 所有操作都可以通过自然语言进行。
由 [Nuvem Fiscal](https://www.nuvemfiscal.com.br/) API 提供支持。
## 工具列表
| 工具 | 描述 |
|------|-----------|
| `consultar_cnpj` | 查询联邦税务局的 CNPJ 公共数据 |
| `status_sefaz` | 按 UF 查询 Sefaz 的可用性 |
| `listar_nfe` | 列出由 CNPJ 发出的 NF-e |
| `consultar_nfe` | 特定 NF-e 的详细信息 |
| `emitir_nfe` | 发出新的 NF-e |
| `cancelar_nfe` | 取消 NF-e（24 小时内） |
| `carta_correcao_nfe` | NF-e 的更正函 |
| `baixar_pdf_nfe` | 下载 DANFE 的 PDF |
| `baixar_xml_nfe` | 下载已签名的 XML |
| `inutilizar_nfe` | 作废编号范围 |
| `listar_nfse` | 列出已发出的 NFS-e |
| `consultar_nfse` | NFS-e 的详细信息 |
| `emitir_nfse` | 发出新的 NFS-e |
| `cancelar_nfse` | 取消 NFS-e |
| `consultar_empresa` | Nuvem Fiscal 中的企业数据 |
| `cadastrar_empresa` | 注册企业以便发出 |
## 设置
### 1. 获取 Nuvem Fiscal 的令牌
在 [nuvemfiscal.com.br](https://www.nuvemfiscal.com.br/) 上创建帐户并生成 API 令牌。
### 2. 在 Claude Code 中配置
将以下内容添加到您的 `claude_desktop_config.json` 或 `settings.json` 中：
```json
{
"mcpServers": {
"nota-fiscal": {
"command": "npx",
"args": ["-y", "@rodrigodocarmo/mcp-nota-fiscal"],
"env": {
"NUVEM_FISCAL_TOKEN": "您的令牌",
"NUVEM_FISCAL_SANDBOX": "true"
}
}
}
}
```
### 3. 通过本地 npm 使用
```bash
npm install @rodrigodocarmo/mcp-nota-fiscal
```
## 环境变量
| 变量 | 是否必填 | 描述 |
|----------|-------------|-----------|
| `NUVEM_FISCAL_TOKEN` | 是 | Nuvem Fiscal API 访问令牌 |
| `NUVEM_FISCAL_SANDBOX` | 否 | `true`（默认）或 `false` 表示生产环境 |
## 使用示例
> "查询 CNPJ 00.000.000/0001-91"
> "列出我公司最近的 5 张增值税发票"
> "检查 São Paulo 的 Sefaz 是否在线"
> "取消增值税发票 X，理由是 Y"
## 开发
```bash
git clone https://github.com/rodrigo-do-carmo/mcp-nota-fiscal
cd mcp-nota-fiscal
npm install
npm run dev # 监视模式
npm run build # 编译
```
## 许可证
MIT
