原型 · 预览版:收录官方注册中心里的全部服务器,每 30 分钟同步一次。使用 Google 登录即可撰写评价。原型 · 每 30 分钟更新
PopNx MCP为使用 AI 的人准备的 MCP 服务器 · 用大白话讲清楚

gov.br APIs MCP

作者:thalisantunes版本 0.2.0i★ 1i在你的电脑上运行代码仓库 ↗
注册名称io.github.thalisantunes/govbr-apis-mcp

安装方法

What it does

A catalog-driven gateway over Brazilian government APIs, loading OpenAPI specs on demand.

  • Connects 在你的电脑上运行
  • Account or key Needs TRANSPARENCIA_API_KEY, DATAJUD_API_KEY, DADOSGOV_API_KEY, SERPRO_CPF_CLIENT_ID, SERPRO_CPF_CLIENT_SECRET, SERPRO_CNPJ_CLIENT_ID, SERPRO_CNPJ_CLIENT_SECRET, SERPRO_DATAVALID_CLIENT_ID, SERPRO_DATAVALID_CLIENT_SECRET, MEIAENTRADA_CODIGO_ACESSO
  • Category 法律与政府数据

为什么排在这里

列表按使用分(满分 100)排序,由以下部分组成

热度4/80GitHub 星标或每周下载量:较大的计 60,较小的计 20
新鲜度12/1230 天内有发布或代码更新得满分
仍在响应0/8上次检查时云端端点有响应
使用分16/100

质量: 基础检查通过 3/3 项(仅展示,不用于排序) · 上升势头: 暂无数据 (只用于“上升中”标签)

安装

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

用一句话让 AI 帮你安装

请帮我安装 gov.br APIs MCP。按照 https://mcp.popnx.com/i/thalisantunes-govbr-apis-mcp.md 操作,先把命令给我看,等我同意后再运行。

粘贴到能在你电脑上工作的 AI(如 Claude Code、Cursor)。它会读取我们的步骤,先给你看命令,等你同意。无需密钥,无需注册。 · 查看 AI 会读取的全文

通过 3/3 项检查 · 在你的电脑上运行 · ✓ 命令已检查 2026年11月14日

第一步:你用哪个 AI?

选择你用的应用,步骤会显示在下方。

可连接 Claude,但需要先准备

需要 gov.br APIs MCP 的密钥(在开发者网站创建) · 需要先在电脑上安装 Python (uv)(只需一次) · 仅限电脑上的 Claude 应用(Windows 或 Mac),网页和手机不可用

让 AI 帮你安装

把这段话复制到 Claude 的对话里。AI 会先检查电脑,告诉你要改哪个文件,并且每次都等你同意。

请在这台电脑上为 Claude 安装 MCP server gov.br APIs MCP,按顺序:1) 用 uv --version 检查是否有 uv。没有的话,请让我从 https://docs.astral.sh/uv/getting-started/installation/ 安装,不要自己安装。2) 只使用这份配置(已通过 PopNx MCP 检查):{ "mcpServers": { "govbr-apis": { "command": "uvx", "args": [ "govbr-apis-mcp" ], "env": { "TRANSPARENCIA_API_KEY": "your-value", "DATAJUD_API_KEY": "your-value", "DADOSGOV_API_KEY": "your-value", "SERPRO_CPF_CLIENT_ID": "your-value", "SERPRO_CPF_CLIENT_SECRET": "your-value", "SERPRO_CNPJ_CLIENT_ID": "your-value", "SERPRO_CNPJ_CLIENT_SECRET": "your-value", "SERPRO_DATAVALID_CLIENT_ID": "your-value", "SERPRO_DATAVALID_CLIENT_SECRET": "your-value", "MEIAENTRADA_CODIGO_ACESSO": "your-value" } } } } 3) 告诉我要修改的文件完整路径或要运行的命令,等我同意。4) TRANSPARENCIA_API_KEY, DATAJUD_API_KEY, DADOSGOV_API_KEY, SERPRO_CPF_CLIENT_ID, SERPRO_CPF_CLIENT_SECRET, SERPRO_CNPJ_CLIENT_ID, SERPRO_CNPJ_CLIENT_SECRET, SERPRO_DATAVALID_CLIENT_ID, SERPRO_DATAVALID_CLIENT_SECRET, MEIAENTRADA_CODIGO_ACESSO 先保留 "your-value",请我自己把真实值粘贴到文件或应用的输入框里。不要让我在对话里输入密钥。5) 按约定执行,然后确认 gov.br APIs MCP 的工具真的出现了。

这段话不包含你的密钥。如果需要密钥,AI 会请你自己粘贴到文件或应用的输入框里。

  1. 安装 uv(如果还没有)

    已经装好了吗?先检查 · 打开终端,输入这条命令后按 Enter

    uv --version
    • 显示版本号(例如 uv …)= 已安装,可跳过这一步
    • 显示 "command not found"(Windows 显示 "is not recognized")= 还没安装,或刚装好但需要关掉终端再重新打开
    怎么打开终端

    Mac:按 ⌘ + Space,输入 Terminal 后按 Enter

    Windows:打开“开始”菜单,输入 Windows PowerShell,然后选“打开”

    还没安装: uv 没有点选式安装程序。从 uv 官方页面复制适合你系统(macOS 或 Windows)的一行命令,粘贴到终端 · 不需要单独安装 Python,uv 会在需要时自动下载

    打开 uv 下载页 ↗

    装好后关掉终端再打开,重新运行同一条命令,应显示版本号: uv --version

    安装一次,所有需要 uv 的工具都能用

  2. 注册并创建 gov.br APIs MCP 的密钥

    打开开发者网站,注册账户并创建 API 密钥,下一步要用。价格和免费方案请看开发者网站。

    获取密钥的方法见下方开发者的 README

  3. 打开电脑版 Claude 应用的设置文件

    SettingsDeveloperEdit Config

  4. 粘贴这些设置并保存文件

    {
      "mcpServers": {
        "govbr-apis": {
          "command": "uvx",
          "args": [
            "govbr-apis-mcp"
          ],
          "env": {
            "TRANSPARENCIA_API_KEY": "your-value",
            "DATAJUD_API_KEY": "your-value",
            "DADOSGOV_API_KEY": "your-value",
            "SERPRO_CPF_CLIENT_ID": "your-value",
            "SERPRO_CPF_CLIENT_SECRET": "your-value",
            "SERPRO_CNPJ_CLIENT_ID": "your-value",
            "SERPRO_CNPJ_CLIENT_SECRET": "your-value",
            "SERPRO_DATAVALID_CLIENT_ID": "your-value",
            "SERPRO_DATAVALID_CLIENT_SECRET": "your-value",
            "MEIAENTRADA_CODIGO_ACESSO": "your-value"
          }
        }
      }
    }

    只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人

  5. 退出 Claude 再重新打开

  6. 试一试

    用 gov.br APIs MCP 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 Claude 说正在使用 gov.br APIs MCP,或回答中出现 gov.br APIs MCP 的工具名称,就表示连接成功

4 项可选设置(不填也能用)

上面的命令不填这些也能用。想调整时再按开发者的说明添加。

  • GOVBR_CATALOG_DIR 包含目录 YAML 文件的目录,用于替换随包提供的目录(受信任的输入)。
    查看英文原文Directory of catalog YAML files that replaces the packaged catalog (trusted input)
  • GOVBR_EXTRA_CATALOG_DIR 目录中的目录 YAML 文件,其条目将添加到目录中,并覆盖具有相同 ID 的条目。
    查看英文原文Directory of catalog YAML files whose entries are added to the catalog, overriding same-id ones
  • GOVBR_EXTRA_ALLOWED_HOSTS 目录 URL 可以使用的额外主机名列表,以逗号分隔;仅当你信任其可以接收发送给它的凭据时才添加
    查看英文原文Comma-separated extra hostnames catalog URLs may use; add one only if you trust it with the credentials sent there
  • XDG_CACHE_HOME OpenAPI 规范缓存的基础目录(其下会创建 govbr-apis-mcp 文件夹);默认值为 /.cache
    查看英文原文Base directory of the OpenAPI spec cache (a govbr-apis-mcp folder is created below it); defaults to ~/.cache

说明为自动翻译,变量名保持原样;不确定时请查看原文。

菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同

ChatGPT 暂时无法连接 gov.br APIs MCP

gov.br APIs MCP 需要安装在你的电脑上,而 ChatGPT 只能连接在网上运行的服务器

你可以改用这些方式

A · 使用能连接 gov.br APIs MCP 的应用

  • 需要 gov.br APIs MCP 的密钥(在开发者网站创建) · 需要先在电脑上安装 Python (uv)(只需一次) · 仅限电脑上的 Claude 应用(Windows 或 Mac),网页和手机不可用
  • 需要 gov.br APIs MCP 的密钥(在开发者网站创建) · 需要先在电脑上安装 Python (uv)(只需一次)
  • 需要 gov.br APIs MCP 的密钥(在开发者网站创建) · 需要先在电脑上安装 Python (uv)(只需一次)
  • 需要 gov.br APIs MCP 的密钥(在开发者网站创建) · 需要先在电脑上安装 Python (uv)(只需一次)

B · 法律与政府数据 类中能连接 ChatGPT 的其他服务器

从同类中使用较多的里挑选,仅限用地址即可连接、无需密钥的

可连接 Claude Code,但需要先准备

需要 gov.br APIs MCP 的密钥(在开发者网站创建) · 需要先在电脑上安装 Python (uv)(只需一次)

让 AI 帮你安装

把这段话复制到 Claude Code 的对话里。AI 会先检查电脑,告诉你要改哪个文件,并且每次都等你同意。

请在这台电脑上为 Claude Code 安装 MCP server gov.br APIs MCP,按顺序:1) 用 uv --version 检查是否有 uv。没有的话,请让我从 https://docs.astral.sh/uv/getting-started/installation/ 安装,不要自己安装。2) 只使用这份配置(已通过 PopNx MCP 检查):claude mcp add --scope user govbr-apis --env TRANSPARENCIA_API_KEY=your-value --env DATAJUD_API_KEY=your-value --env DADOSGOV_API_KEY=your-value --env SERPRO_CPF_CLIENT_ID=your-value --env SERPRO_CPF_CLIENT_SECRET=your-value --env SERPRO_CNPJ_CLIENT_ID=your-value --env SERPRO_CNPJ_CLIENT_SECRET=your-value --env SERPRO_DATAVALID_CLIENT_ID=your-value --env SERPRO_DATAVALID_CLIENT_SECRET=your-value --env MEIAENTRADA_CODIGO_ACESSO=your-value -- uvx govbr-apis-mcp 3) 告诉我要修改的文件完整路径或要运行的命令,等我同意。4) TRANSPARENCIA_API_KEY, DATAJUD_API_KEY, DADOSGOV_API_KEY, SERPRO_CPF_CLIENT_ID, SERPRO_CPF_CLIENT_SECRET, SERPRO_CNPJ_CLIENT_ID, SERPRO_CNPJ_CLIENT_SECRET, SERPRO_DATAVALID_CLIENT_ID, SERPRO_DATAVALID_CLIENT_SECRET, MEIAENTRADA_CODIGO_ACESSO 先保留 "your-value",请我自己把真实值粘贴到文件或应用的输入框里。不要让我在对话里输入密钥。5) 按约定执行,然后确认 gov.br APIs MCP 的工具真的出现了。

这段话不包含你的密钥。如果需要密钥,AI 会请你自己粘贴到文件或应用的输入框里。

  1. 安装 uv(如果还没有)

    已经装好了吗?先检查 · 打开终端,输入这条命令后按 Enter

    uv --version
    • 显示版本号(例如 uv …)= 已安装,可跳过这一步
    • 显示 "command not found"(Windows 显示 "is not recognized")= 还没安装,或刚装好但需要关掉终端再重新打开
    怎么打开终端

    Mac:按 ⌘ + Space,输入 Terminal 后按 Enter

    Windows:打开“开始”菜单,输入 Windows PowerShell,然后选“打开”

    还没安装: uv 没有点选式安装程序。从 uv 官方页面复制适合你系统(macOS 或 Windows)的一行命令,粘贴到终端 · 不需要单独安装 Python,uv 会在需要时自动下载

    打开 uv 下载页 ↗

    装好后关掉终端再打开,重新运行同一条命令,应显示版本号: uv --version

    安装一次,所有需要 uv 的工具都能用

  2. 注册并创建 gov.br APIs MCP 的密钥

    打开开发者网站,注册账户并创建 API 密钥,下一步要用。价格和免费方案请看开发者网站。

    获取密钥的方法见下方开发者的 README

  3. 打开终端

    Mac:按 Command+空格,输入 Terminal · Windows:打开 PowerShell

  4. 粘贴这条命令并按 Enter

    claude mcp add --scope user govbr-apis --env TRANSPARENCIA_API_KEY=your-value --env DATAJUD_API_KEY=your-value --env DADOSGOV_API_KEY=your-value --env SERPRO_CPF_CLIENT_ID=your-value --env SERPRO_CPF_CLIENT_SECRET=your-value --env SERPRO_CNPJ_CLIENT_ID=your-value --env SERPRO_CNPJ_CLIENT_SECRET=your-value --env SERPRO_DATAVALID_CLIENT_ID=your-value --env SERPRO_DATAVALID_CLIENT_SECRET=your-value --env MEIAENTRADA_CODIGO_ACESSO=your-value -- uvx govbr-apis-mcp

    按 Enter 前,把“your-value”改成你的密钥

    只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人

  5. 在 Claude Code 中输入 /mcp

    应能看到 gov.br APIs MCP 在列表中并显示已连接

  6. 试一试

    用 gov.br APIs MCP 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 Claude Code 说正在使用 gov.br APIs MCP,或回答中出现 gov.br APIs MCP 的工具名称,就表示连接成功

4 项可选设置(不填也能用)

上面的命令不填这些也能用。想调整时再按开发者的说明添加。

  • GOVBR_CATALOG_DIR 包含目录 YAML 文件的目录,用于替换随包提供的目录(受信任的输入)。
    查看英文原文Directory of catalog YAML files that replaces the packaged catalog (trusted input)
  • GOVBR_EXTRA_CATALOG_DIR 目录中的目录 YAML 文件,其条目将添加到目录中,并覆盖具有相同 ID 的条目。
    查看英文原文Directory of catalog YAML files whose entries are added to the catalog, overriding same-id ones
  • GOVBR_EXTRA_ALLOWED_HOSTS 目录 URL 可以使用的额外主机名列表,以逗号分隔;仅当你信任其可以接收发送给它的凭据时才添加
    查看英文原文Comma-separated extra hostnames catalog URLs may use; add one only if you trust it with the credentials sent there
  • XDG_CACHE_HOME OpenAPI 规范缓存的基础目录(其下会创建 govbr-apis-mcp 文件夹);默认值为 /.cache
    查看英文原文Base directory of the OpenAPI spec cache (a govbr-apis-mcp folder is created below it); defaults to ~/.cache

说明为自动翻译,变量名保持原样;不确定时请查看原文。

菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同

可连接 Cursor,但需要先准备

需要 gov.br APIs MCP 的密钥(在开发者网站创建) · 需要先在电脑上安装 Python (uv)(只需一次)

让 AI 帮你安装

把这段话复制到 Cursor 的对话里。AI 会先检查电脑,告诉你要改哪个文件,并且每次都等你同意。

请在这台电脑上为 Cursor 安装 MCP server gov.br APIs MCP,按顺序:1) 用 uv --version 检查是否有 uv。没有的话,请让我从 https://docs.astral.sh/uv/getting-started/installation/ 安装,不要自己安装。2) 只使用这份配置(已通过 PopNx MCP 检查):{ "mcpServers": { "govbr-apis": { "command": "uvx", "args": [ "govbr-apis-mcp" ], "env": { "TRANSPARENCIA_API_KEY": "your-value", "DATAJUD_API_KEY": "your-value", "DADOSGOV_API_KEY": "your-value", "SERPRO_CPF_CLIENT_ID": "your-value", "SERPRO_CPF_CLIENT_SECRET": "your-value", "SERPRO_CNPJ_CLIENT_ID": "your-value", "SERPRO_CNPJ_CLIENT_SECRET": "your-value", "SERPRO_DATAVALID_CLIENT_ID": "your-value", "SERPRO_DATAVALID_CLIENT_SECRET": "your-value", "MEIAENTRADA_CODIGO_ACESSO": "your-value" } } } } 3) 告诉我要修改的文件完整路径或要运行的命令,等我同意。4) TRANSPARENCIA_API_KEY, DATAJUD_API_KEY, DADOSGOV_API_KEY, SERPRO_CPF_CLIENT_ID, SERPRO_CPF_CLIENT_SECRET, SERPRO_CNPJ_CLIENT_ID, SERPRO_CNPJ_CLIENT_SECRET, SERPRO_DATAVALID_CLIENT_ID, SERPRO_DATAVALID_CLIENT_SECRET, MEIAENTRADA_CODIGO_ACESSO 先保留 "your-value",请我自己把真实值粘贴到文件或应用的输入框里。不要让我在对话里输入密钥。5) 按约定执行,然后确认 gov.br APIs MCP 的工具真的出现了。

这段话不包含你的密钥。如果需要密钥,AI 会请你自己粘贴到文件或应用的输入框里。

  1. 安装 uv(如果还没有)

    已经装好了吗?先检查 · 打开终端,输入这条命令后按 Enter

    uv --version
    • 显示版本号(例如 uv …)= 已安装,可跳过这一步
    • 显示 "command not found"(Windows 显示 "is not recognized")= 还没安装,或刚装好但需要关掉终端再重新打开
    怎么打开终端

    Mac:按 ⌘ + Space,输入 Terminal 后按 Enter

    Windows:打开“开始”菜单,输入 Windows PowerShell,然后选“打开”

    还没安装: uv 没有点选式安装程序。从 uv 官方页面复制适合你系统(macOS 或 Windows)的一行命令,粘贴到终端 · 不需要单独安装 Python,uv 会在需要时自动下载

    打开 uv 下载页 ↗

    装好后关掉终端再打开,重新运行同一条命令,应显示版本号: uv --version

    安装一次,所有需要 uv 的工具都能用

  2. 注册并创建 gov.br APIs MCP 的密钥

    打开开发者网站,注册账户并创建 API 密钥,下一步要用。价格和免费方案请看开发者网站。

    获取密钥的方法见下方开发者的 README

  3. 点击这个按钮打开 Cursor

    在 Cursor 中打开

    Cursor 会请你确认安装,点击 Install

  4. 填写你的密钥

    在 gov.br APIs MCP 的设置中,TRANSPARENCIA_API_KEY, DATAJUD_API_KEY, DADOSGOV_API_KEY, SERPRO_CPF_CLIENT_ID, SERPRO_CPF_CLIENT_SECRET, SERPRO_CNPJ_CLIENT_ID, SERPRO_CNPJ_CLIENT_SECRET, SERPRO_DATAVALID_CLIENT_ID, SERPRO_DATAVALID_CLIENT_SECRET, MEIAENTRADA_CODIGO_ACESSO 还是空的,填入你的密钥并保存

    只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人

  5. 在 Cursor 中以 Agent 模式打开 AI 聊天

  6. 试一试

    用 gov.br APIs MCP 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 Cursor 说正在使用 gov.br APIs MCP,或回答中出现 gov.br APIs MCP 的工具名称,就表示连接成功

4 项可选设置(不填也能用)

上面的命令不填这些也能用。想调整时再按开发者的说明添加。

  • GOVBR_CATALOG_DIR 包含目录 YAML 文件的目录,用于替换随包提供的目录(受信任的输入)。
    查看英文原文Directory of catalog YAML files that replaces the packaged catalog (trusted input)
  • GOVBR_EXTRA_CATALOG_DIR 目录中的目录 YAML 文件,其条目将添加到目录中,并覆盖具有相同 ID 的条目。
    查看英文原文Directory of catalog YAML files whose entries are added to the catalog, overriding same-id ones
  • GOVBR_EXTRA_ALLOWED_HOSTS 目录 URL 可以使用的额外主机名列表,以逗号分隔;仅当你信任其可以接收发送给它的凭据时才添加
    查看英文原文Comma-separated extra hostnames catalog URLs may use; add one only if you trust it with the credentials sent there
  • XDG_CACHE_HOME OpenAPI 规范缓存的基础目录(其下会创建 govbr-apis-mcp 文件夹);默认值为 /.cache
    查看英文原文Base directory of the OpenAPI spec cache (a govbr-apis-mcp folder is created below it); defaults to ~/.cache

说明为自动翻译,变量名保持原样;不确定时请查看原文。

菜单名称已于 2026年11月11日 对照 Cursor 帮助页面核实 · 你的界面可能因版本略有不同

可连接 VS Code,但需要先准备

需要 gov.br APIs MCP 的密钥(在开发者网站创建) · 需要先在电脑上安装 Python (uv)(只需一次)

让 AI 帮你安装

把这段话复制到 VS Code 的对话里。AI 会先检查电脑,告诉你要改哪个文件,并且每次都等你同意。

请在这台电脑上为 VS Code 安装 MCP server gov.br APIs MCP,按顺序:1) 用 uv --version 检查是否有 uv。没有的话,请让我从 https://docs.astral.sh/uv/getting-started/installation/ 安装,不要自己安装。2) 只使用这份配置(已通过 PopNx MCP 检查):{ "servers": { "govbr-apis": { "type": "stdio", "command": "uvx", "args": [ "govbr-apis-mcp" ], "env": { "TRANSPARENCIA_API_KEY": "your-value", "DATAJUD_API_KEY": "your-value", "DADOSGOV_API_KEY": "your-value", "SERPRO_CPF_CLIENT_ID": "your-value", "SERPRO_CPF_CLIENT_SECRET": "your-value", "SERPRO_CNPJ_CLIENT_ID": "your-value", "SERPRO_CNPJ_CLIENT_SECRET": "your-value", "SERPRO_DATAVALID_CLIENT_ID": "your-value", "SERPRO_DATAVALID_CLIENT_SECRET": "your-value", "MEIAENTRADA_CODIGO_ACESSO": "your-value" } } } } 3) 告诉我要修改的文件完整路径或要运行的命令,等我同意。4) TRANSPARENCIA_API_KEY, DATAJUD_API_KEY, DADOSGOV_API_KEY, SERPRO_CPF_CLIENT_ID, SERPRO_CPF_CLIENT_SECRET, SERPRO_CNPJ_CLIENT_ID, SERPRO_CNPJ_CLIENT_SECRET, SERPRO_DATAVALID_CLIENT_ID, SERPRO_DATAVALID_CLIENT_SECRET, MEIAENTRADA_CODIGO_ACESSO 先保留 "your-value",请我自己把真实值粘贴到文件或应用的输入框里。不要让我在对话里输入密钥。5) 按约定执行,然后确认 gov.br APIs MCP 的工具真的出现了。

这段话不包含你的密钥。如果需要密钥,AI 会请你自己粘贴到文件或应用的输入框里。

  1. 安装 uv(如果还没有)

    已经装好了吗?先检查 · 打开终端,输入这条命令后按 Enter

    uv --version
    • 显示版本号(例如 uv …)= 已安装,可跳过这一步
    • 显示 "command not found"(Windows 显示 "is not recognized")= 还没安装,或刚装好但需要关掉终端再重新打开
    怎么打开终端

    Mac:按 ⌘ + Space,输入 Terminal 后按 Enter

    Windows:打开“开始”菜单,输入 Windows PowerShell,然后选“打开”

    还没安装: uv 没有点选式安装程序。从 uv 官方页面复制适合你系统(macOS 或 Windows)的一行命令,粘贴到终端 · 不需要单独安装 Python,uv 会在需要时自动下载

    打开 uv 下载页 ↗

    装好后关掉终端再打开,重新运行同一条命令,应显示版本号: uv --version

    安装一次,所有需要 uv 的工具都能用

  2. 注册并创建 gov.br APIs MCP 的密钥

    打开开发者网站,注册账户并创建 API 密钥,下一步要用。价格和免费方案请看开发者网站。

    获取密钥的方法见下方开发者的 README

  3. 点击这个按钮打开 VS Code

    在 VS Code 中打开

    VS Code 会请你确认安装,点击 Install

  4. 填写你的密钥

    在 gov.br APIs MCP 的设置中,TRANSPARENCIA_API_KEY, DATAJUD_API_KEY, DADOSGOV_API_KEY, SERPRO_CPF_CLIENT_ID, SERPRO_CPF_CLIENT_SECRET, SERPRO_CNPJ_CLIENT_ID, SERPRO_CNPJ_CLIENT_SECRET, SERPRO_DATAVALID_CLIENT_ID, SERPRO_DATAVALID_CLIENT_SECRET, MEIAENTRADA_CODIGO_ACESSO 还是空的,填入你的密钥并保存

    只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人

  5. 在 VS Code 中以 Agent 模式打开 AI 聊天

  6. 试一试

    用 gov.br APIs MCP 告诉我你能帮我做什么,然后做一件给我看

    ✓ 如果 VS Code 说正在使用 gov.br APIs MCP,或回答中出现 gov.br APIs MCP 的工具名称,就表示连接成功

4 项可选设置(不填也能用)

上面的命令不填这些也能用。想调整时再按开发者的说明添加。

  • GOVBR_CATALOG_DIR 包含目录 YAML 文件的目录,用于替换随包提供的目录(受信任的输入)。
    查看英文原文Directory of catalog YAML files that replaces the packaged catalog (trusted input)
  • GOVBR_EXTRA_CATALOG_DIR 目录中的目录 YAML 文件,其条目将添加到目录中,并覆盖具有相同 ID 的条目。
    查看英文原文Directory of catalog YAML files whose entries are added to the catalog, overriding same-id ones
  • GOVBR_EXTRA_ALLOWED_HOSTS 目录 URL 可以使用的额外主机名列表,以逗号分隔;仅当你信任其可以接收发送给它的凭据时才添加
    查看英文原文Comma-separated extra hostnames catalog URLs may use; add one only if you trust it with the credentials sent there
  • XDG_CACHE_HOME OpenAPI 规范缓存的基础目录(其下会创建 govbr-apis-mcp 文件夹);默认值为 /.cache
    查看英文原文Base directory of the OpenAPI spec cache (a govbr-apis-mcp folder is created below it); defaults to ~/.cache

说明为自动翻译,变量名保持原样;不确定时请查看原文。

菜单名称已于 2026年11月11日 对照 VS Code 帮助页面核实 · 你的界面可能因版本略有不同

其他支持 MCP 的应用(如 Windsurf、Zed、Gemini CLI)添加方式各不相同,请在应用列表中查看

查看所有支持 MCP 的应用 →

JSON 设置在下方“开发者专用”中

卡住了?问问正在用 gov.br APIs MCP 的人💬 讨论 →
开发者专用:终端命令和 JSON 设置

安装在电脑上

Claude Code

claude mcp add --scope user govbr-apis --env TRANSPARENCIA_API_KEY=your-value --env DATAJUD_API_KEY=your-value --env DADOSGOV_API_KEY=your-value --env SERPRO_CPF_CLIENT_ID=your-value --env SERPRO_CPF_CLIENT_SECRET=your-value --env SERPRO_CNPJ_CLIENT_ID=your-value --env SERPRO_CNPJ_CLIENT_SECRET=your-value --env SERPRO_DATAVALID_CLIENT_ID=your-value --env SERPRO_DATAVALID_CLIENT_SECRET=your-value --env MEIAENTRADA_CODIGO_ACESSO=your-value -- uvx govbr-apis-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "govbr-apis": {
      "command": "uvx",
      "args": [
        "govbr-apis-mcp"
      ],
      "env": {
        "TRANSPARENCIA_API_KEY": "your-value",
        "DATAJUD_API_KEY": "your-value",
        "DADOSGOV_API_KEY": "your-value",
        "SERPRO_CPF_CLIENT_ID": "your-value",
        "SERPRO_CPF_CLIENT_SECRET": "your-value",
        "SERPRO_CNPJ_CLIENT_ID": "your-value",
        "SERPRO_CNPJ_CLIENT_SECRET": "your-value",
        "SERPRO_DATAVALID_CLIENT_ID": "your-value",
        "SERPRO_DATAVALID_CLIENT_SECRET": "your-value",
        "MEIAENTRADA_CODIGO_ACESSO": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "govbr-apis": {
      "command": "uvx",
      "args": [
        "govbr-apis-mcp"
      ],
      "env": {
        "TRANSPARENCIA_API_KEY": "your-value",
        "DATAJUD_API_KEY": "your-value",
        "DADOSGOV_API_KEY": "your-value",
        "SERPRO_CPF_CLIENT_ID": "your-value",
        "SERPRO_CPF_CLIENT_SECRET": "your-value",
        "SERPRO_CNPJ_CLIENT_ID": "your-value",
        "SERPRO_CNPJ_CLIENT_SECRET": "your-value",
        "SERPRO_DATAVALID_CLIENT_ID": "your-value",
        "SERPRO_DATAVALID_CLIENT_SECRET": "your-value",
        "MEIAENTRADA_CODIGO_ACESSO": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "govbr-apis": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "govbr-apis-mcp"
      ],
      "env": {
        "TRANSPARENCIA_API_KEY": "your-value",
        "DATAJUD_API_KEY": "your-value",
        "DADOSGOV_API_KEY": "your-value",
        "SERPRO_CPF_CLIENT_ID": "your-value",
        "SERPRO_CPF_CLIENT_SECRET": "your-value",
        "SERPRO_CNPJ_CLIENT_ID": "your-value",
        "SERPRO_CNPJ_CLIENT_SECRET": "your-value",
        "SERPRO_DATAVALID_CLIENT_ID": "your-value",
        "SERPRO_DATAVALID_CLIENT_SECRET": "your-value",
        "MEIAENTRADA_CODIGO_ACESSO": "your-value"
      }
    }
  }
}

需要你填写的值

  • TRANSPARENCIA_API_KEY 机密 必填 env
    Portal da Transparencia API 的 API 密钥。
    查看英文原文API key for the Portal da Transparencia API
  • DATAJUD_API_KEY 机密 必填 env
    CNJ DataJud API 的 API 密钥。
    查看英文原文API key for the CNJ DataJud API
  • DADOSGOV_API_KEY 机密 必填 env
    dados.gov.br 门户 API 的密钥(免费,可在用户资料中生成)。
    查看英文原文API key for the dados.gov.br portal API (free, generated in the user profile)
  • SERPRO_CPF_CLIENT_ID 机密 必填 env
    Serpro CPF API 的 OAuth2 客户端 ID(商业合同)
    查看英文原文OAuth2 client ID for the Serpro CPF API (commercial contract)
  • SERPRO_CPF_CLIENT_SECRET 机密 必填 env
    Serpro CPF API 的 OAuth2 客户端密钥(商业合同)。
    查看英文原文OAuth2 client secret for the Serpro CPF API (commercial contract)
  • SERPRO_CNPJ_CLIENT_ID 机密 必填 env
    Serpro CNPJ API 的 OAuth2 客户端 ID(商业合同)
    查看英文原文OAuth2 client ID for the Serpro CNPJ API (commercial contract)
  • SERPRO_CNPJ_CLIENT_SECRET 机密 必填 env
    Serpro CNPJ API 的 OAuth2 客户端密钥(商业合同)。
    查看英文原文OAuth2 client secret for the Serpro CNPJ API (commercial contract)
  • SERPRO_DATAVALID_CLIENT_ID 机密 必填 env
    Serpro Datavalid API 的 OAuth2 客户端 ID(商业合同)
    查看英文原文OAuth2 client ID for the Serpro Datavalid API (commercial contract)
  • SERPRO_DATAVALID_CLIENT_SECRET 机密 必填 env
    Serpro Datavalid API 的 OAuth2 客户端密钥(商业合同)。
    查看英文原文OAuth2 client secret for the Serpro Datavalid API (commercial contract)
  • MEIAENTRADA_CODIGO_ACESSO 机密 必填 env
    用于 meia-entrada 的 CIE 验证器的访问代码(codigoAcesso),由场所或制作方签发
    查看英文原文Access code (codigoAcesso) for the CIE validator used for meia-entrada, issued to the venue or producer
  • GOVBR_CATALOG_DIR env
    包含目录 YAML 文件的目录,用于替换随包提供的目录(受信任的输入)。
    查看英文原文Directory of catalog YAML files that replaces the packaged catalog (trusted input)
  • GOVBR_EXTRA_CATALOG_DIR env
    目录中的目录 YAML 文件,其条目将添加到目录中,并覆盖具有相同 ID 的条目。
    查看英文原文Directory of catalog YAML files whose entries are added to the catalog, overriding same-id ones
  • GOVBR_EXTRA_ALLOWED_HOSTS env
    目录 URL 可以使用的额外主机名列表,以逗号分隔;仅当你信任其可以接收发送给它的凭据时才添加
    查看英文原文Comma-separated extra hostnames catalog URLs may use; add one only if you trust it with the credentials sent there
  • XDG_CACHE_HOME env
    OpenAPI 规范缓存的基础目录(其下会创建 govbr-apis-mcp 文件夹);默认值为 /.cache
    查看英文原文Base directory of the OpenAPI spec cache (a govbr-apis-mcp folder is created below it); defaults to ~/.cache

说明为自动翻译,变量名保持原样;不确定时请查看原文。

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

一览

每周下载量i
23/周
连接方式
在你的电脑上运行
最新版本i
0.2.0
发布到注册中心i
2026年10月20日
代码最后更新i
2026年11月13日
作者
thalisantunes
软件包
pypi: govbr-apis-mcp
注册状态
活跃

哪些应用可以使用它

依据这个服务器的连接方式和各应用自己的文档,检查于 2026年11月10日。

在你的电脑上运行,适用于

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

全部应用及其优缺点 →

它能做什么

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

基础检查i

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

  • ✓ 通过

    作者与仓库一致

    注册名称已通过 GitHub 账户 thalisantunes 验证,该账户拥有此仓库

  • ✓ 通过

    仍在维护

    代码最后更新于6天前

  • ✓ 通过

    有许可证

    使用 MIT

  • – 不适用

    端点有响应

    它在你的电脑上运行,没有互联网端点

  • – 不适用

    使用 OAuth 登录

    在你的电脑上运行,改用本地设置

  • … 尚未检查

    工具描述中没有隐藏指令

    它在你的电脑上运行;我们只能读取互联网端点的工具列表

已公开的漏洞(OSV.dev)

OSV.dev 中没有 govbr-apis-mcp@0.2.0 的记录

只检查这个版本的包本身,不包括所有依赖 · 检查于 2026年11月15日

我们检查什么 → · JSON

作者:申请重新检查或报告信息错误
给作者:在 README 中加徽章

如果你是作者,可把这段代码贴到 README。徽章会链接回本页。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/thalisantunes-govbr-apis-mcp.svg)](https://mcp.popnx.com/en/servers/thalisantunes-govbr-apis-mcp)

讨论

提问、分享技巧或报告无法使用。按“有帮助”数量排序。

还没有帖子,欢迎第一个提问或分享。

此处内容由用户撰写,不代表 PopNx 团队。

登录后发帖

用户评价

还没有评价

登录后写评价

与“法律与政府数据”中的其他服务器比较i

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

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

常见问题

gov.br APIs MCP 安全吗?

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

它需要哪些密钥或代码?

你需要填写:TRANSPARENCIA_API_KEY, DATAJUD_API_KEY, DADOSGOV_API_KEY, SERPRO_CPF_CLIENT_ID, SERPRO_CPF_CLIENT_SECRET, SERPRO_CNPJ_CLIENT_ID, SERPRO_CNPJ_CLIENT_SECRET, SERPRO_DATAVALID_CLIENT_ID, SERPRO_DATAVALID_CLIENT_SECRET, MEIAENTRADA_CODIGO_ACESSO

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

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

它还在维护吗?

GitHub 仓库最后更新于6天前,最新版本(0.2.0)于30天前进入注册中心。

哪些应用可以使用它?

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

有什么可以替代它?

同一分类中有:Global law, Open Legal Data (Germany), LibreJustice, InfraNode, Fedlex Connector

功能相近的其他选择

同一分类、其他作者、命令已通过检查。官方的排在前面,再按星标排序。

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

Global law

The law of nearly every country on earth, any date: read it, see what changed it, check citations.

作者:lexifina广泛使用★ 20969天前更新

在云端运行✓ lexifina.com

LibreJustice

Search French-language and European case law and French legal texts (codes, statutes, treaties).

作者:librejustice起步阶段★ 362个月前更新

在云端运行✓ 服务方 · librejustice.fr

InfraNode

Keyless open data for 84 German cities: 12 lean read-only MCP tools covering 67 data types.

作者:street1983nk起步阶段★ 185个月前更新

在云端运行✓ 服务方 · infranode.dev
与相似项目对比
本项
gov.br APIs MCP
Global lawOpen Legal Data (Germany)LibreJusticeInfraNodeFedlex Connector
运行位置需要安装在电脑上在云端运行,无需安装在云端运行,无需安装在云端运行,无需安装在云端运行,无需安装在云端运行,无需安装
需要密钥是否否否否否
可在 Claude 中按 + 添加否否否否否否
基础检查3/34/44/44/44/44/4
许可证MITNOASSERTIONMITApache-2.0Apache-2.0MIT
价格登记中未列出费用登记中未列出费用登记中未列出费用登记中未列出费用登记中未列出费用登记中未列出费用

作者的 README

打开 README

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

govbr-apis-mcp

MCP server that turns Brazilian government APIs into Claude-callable tools through a catalog-driven gateway: instead of one tool per endpoint (hundreds — would blow up client context), five generic tools operate over a local YAML catalog of 116 APIs.

Only the entries that declare an openapi_url have a spec to load: today the Câmara dos Deputados and the Portal da Transparência, 2 of the 116. For those, describe_api loads the OpenAPI spec on demand. Every other callable entry (see the "Callable today?" column below) is reached through call_api alone, using the endpoints in its description and docs_url.

Catalog tiers

TierFileAccess modelCallable today?
publicsrc/govbr_apis_mcp/catalog_data/public.yamlFree — no auth or free API key (IBGE, Banco Central, Câmara, Senado, Portal da Transparência, DataJud, Ipeadata, dados.gov.br…)Yes
serprosrc/govbr_apis_mcp/catalog_data/serpro.yamlSerpro commercial (loja.serpro.gov.br) — OAuth2 client credentials per contracted API, paid per callWith a Serpro contract: set the SERPRO_* variables
meia-entradasrc/govbr_apis_mcp/catalog_data/meia_entrada.yamlEligibility sources for half-price tickets (student CIE, ID Jovem, PcD, e-MEC) — see docs/meia-entrada.md and the POCCIE yes (DNE and FESN); the rest is manual
conectasrc/govbr_apis_mcp/catalog_data/conecta.yamlConecta gov.br — restricted to public-sector entities; 95 APIs indexed as stubs for discoveryNot yet (adhesion pending)

The Conecta tier exists so the catalog reflects the whole landscape now, and becomes callable later by filling in base_url + credentials — the OAuth2 client-credentials flow is already implemented (Serpro uses the same one).

Tools

  • search_catalog(query, category?) — accent-insensitive keyword search; reports total matches and whether the list was truncated.
  • list_apis(category?, status?, limit?) — enumerate entries, callable ones first (by the catalog's status, not by whether your credentials are set; filter it: ~95 Conecta stubs otherwise dominate the output).
  • describe_api(api_id, path?, method?) — catalog metadata + OpenAPI operation list; with path, parameter/request/response schemas ($refs inlined, depth-limited). Reads OpenAPI 3 and Swagger 2.0, as JSON or YAML.
  • call_api(api_id, path, method?, query?, body?, headers?) — invoke an endpoint; base URL and auth resolved from the catalog entry.
  • method is GET, HEAD, POST, PUT, PATCH, DELETE or OPTIONS; anything else returns an error with allowed_methods. A body is accepted only with POST, PUT and PATCH.
  • path is relative to the base_url. . and .. segments (after up to three rounds of percent-decoding, with \ read as / and ; parameters removed) and any path that leaves the base_url prefix are rejected. So is a # (a fragment is never sent; write a literal one as %23) or a control character.
  • A query string embedded in path is merged with query; a key in query replaces the embedded one, and a list value repeats the key.
  • Caller headers are matched case-insensitively, with _ equal to -. Authorization, Proxy-Authorization, Host, Cookie and Accept-Encoding, plus connection, proxy, forwarding and method-override headers, are dropped and reported in ignored_headers (the full list is in server.py). The managed credential is applied last and always wins. A header with an invalid name or value is not ignored: it fails the call with an error.
  • Method, body, headers and path are validated before any OAuth2 token is requested, and invalid input comes back as {"error": ...}.
  • A 3xx is not followed: the response carries its location (redacted, resolved against the requested URL). Response bodies are cut at 60,000 characters.
  • credentials_status(api_id?) — which env vars each API needs and whether they're set, plus callable: whether call_api would accept the entry right now (available and unstable entries; requires_contract ones only once their env vars are set).

POC: meia-entrada de estudante

Fluxo funcional ponta a ponta (código da CIE → decisão de elegibilidade), incluindo modo demo sem credencial: poc/README.md.

Install

python3 -m venv .venv

.venv/bin/pip install -e '.[dev]' .venv/bin/pytest

Register in Claude Code (.mcp.json or claude mcp add):

{

"mcpServers": { "govbr-apis": { "command": "/path/to/govbr-apis-mcp/.venv/bin/govbr-apis-mcp", "env": { "TRANSPARENCIA_API_KEY": "...", "DATAJUD_API_KEY": "..." } } } }

From PyPI: uvx govbr-apis-mcp (set "command": "uvx" and "args": ["govbr-apis-mcp"] in the entry above; no checkout needed). Each release is published to PyPI and to the MCP Registry automatically (publish.yml).

Or run it in a container. The server speaks stdio, so keep -i:

docker build -t govbr-apis-mcp . && docker run -i --rm -e TRANSPARENCIA_API_KEY=... govbr-apis-mcp

Credentials

All secrets come from env vars declared per entry in the catalog (auth_config). Nothing is stored in the repo. .env.example lists the variables. Entries with a free key carry a signup_url; Serpro credentials come with the contract, at loja.serpro.gov.br. credentials_status reports readiness.

The server does not read .env files, and MCP clients start it with a minimal environment, so an export in your shell may never reach it. Put the variables in the client's env block (the example above, or claude mcp add -e KEY=value). For a container, copy .env.example to a git-ignored file such as .env.local, fill in the copy and pass it with docker run --env-file .env.local. Never put real values in .env.example: it is versioned.

API keys (the value together with any prefix) are stripped of surrounding whitespace and must be printable ASCII; otherwise the call fails with credential in contains invalid characters, without echoing the value. OAuth2 client ids and secrets are only stripped: they travel base64-encoded, so any text works. The access token the endpoint returns must be printable ASCII too. When the token endpoint fails, the call returns an error and the token_url, with neither the response body nor any secret.

Auth profiles: none, api_key (static header, optional value prefix — e.g. DataJud's APIKey ), oauth2_client_credentials (token endpoint + id/secret, in-memory token cache; used by Serpro today, by Conecta after adhesion).

Extending the catalog

Add an entry to a YAML file in src/govbr_apis_mcp/catalog_data/. The directory is package data, so the wheel, uvx and the Docker image all carry the catalog. Minimum fields: id, name, provider, category, status, auth. Add openapi_url when the API publishes a spec — describe_api then works with zero code. Regenerate the Conecta tier with .venv/bin/python scripts/scrape_conecta.py. It leaves the file alone when the page yields no APIs, an id the catalog would reject, or fewer than half the current entries (--force overrides only the last check).

Entries are validated on load: ids must be filename-safe, URLs must be https on an allowlisted host (*.gov.br, *.leg.br, *.jus.br plus a few named hosts), and a hostname may only contain [a-z0-9.-] (write internationalized names in punycode). This is a security boundary, not style — the catalog decides where your credentials are sent. Add a host with GOVBR_EXTRA_ALLOWED_HOSTS only if you trust it with them; the same hostname rule applies to it.

To override entries without forking (e.g. filling in Conecta base URLs after adhesion), point GOVBR_EXTRA_CATALOG_DIR at a directory of .yaml or .yml files whose same-id entries win. A directory that does not exist or holds no entries is an error, and so is an id repeated inside it; an empty value counts as unset. GOVBR_CATALOG_DIR replaces the base catalog entirely and should be treated as trusted input.

Development

python3 -m venv .venv

.venv/bin/pip install -e '.[dev]' .venv/bin/ruff check . .venv/bin/ruff format --check . .venv/bin/pytest

CI runs ruff on Python 3.12 and the test suite on 3.11–3.14, then builds the wheel and loads the catalog from a clean install.

Security notes

  • Responses are never written to disk. Only OpenAPI specs are cached, in $XDG_CACHE_HOME/govbr-apis-mcp/ (or ~/.cache/govbr-apis-mcp/) for 24 hours, under a file name derived from sha256(api_id + "\n" + openapi_url): never the id itself, and a changed openapi_url never serves the old spec. OAuth2 tokens live in memory only.
  • call_api does not follow redirects — credentialed requests cannot be steered to another host by a 3xx; the response carries the (redacted) location instead. It always sends Accept-Encoding: identity, so a server has no reason to compress. The 60,000-character cut counts decoded text, though: a server that compresses anyway can still inflate a small chunk before the cut (an accepted risk; see the roadmap).
  • Cookies an API sets are never stored or sent back, so one API cannot plant a cookie that another would receive.
  • Spec fetches follow redirects only by hand: at most 5 hops, and every URL (the first and each Location) must be https on an allowlisted host before it is requested. The body is capped at 5 MiB, JSON and YAML are accepted (YAML with aliases, including merge keys that rely on them, is refused), and the document must carry openapi or swagger. A compressed response is refused and the whole download has a 60-second deadline; both come back as spec_error.
  • The httpx and httpcore loggers stay at WARNING, so httpx logs no request URL (query string included).
  • Entries flagged pii: true return personal data (CPF, name, photo) into the client transcript. Today: meiaentrada-cie-validador, fesn-cie-validador (callable without any credential: whoever holds a use code gets the holder's data) and the three Serpro entries.

Roadmap

  • Conecta adhesion as a public-sector entity → fill gateway base URLs + credentials
  • Per-API OpenAPI URLs for Conecta entries (linked from each detail page)
  • Serpro trial-mode toggle (call -trial base URLs with the published demo token)
  • Per-call cost guard for paid Serpro APIs
  • Bounded decompression for compressed upstream responses
  • Pleito à SNJ para a API conecta-id-jovem (admite instituição privada)
  • Fallback documental para CIE fora da base DNE (DCEs e entidades estaduais)

License

MIT - see LICENSE.