Licinexus Mcp

🇧🇷 Português · 🇺🇸 英文版

@licinexusbr/mcp

直接从 Claude Desktop、Cursor、Continue 或任何兼容 MCP 的客户端，以对话方式访问巴西公共招标数据。

由 Licinexus 维护，作为对巴西 govtech 生态系统的开源贡献。

🔔 想接收新版本通知吗？ 点击仓库顶部的 Watch → Custom → Releases — 每次发布新版本都会通知你，但不会刷屏。

📺 上方的演示是一个 CLI 脚本，调用 LLM 使用的同一组适配器，实时连接 PNCP 和 BrasilAPI。Claude Desktop / Cursor 中的体验完全相同 — 工具相同、数据相同，由 LLM 用自然语言进行解读。

---

功能

封装了**国家公共采购门户（PNCP）中最实用的端点以及联邦税务局（Receita Federal）**的 CNPJ 数据，让大模型能够回答有关巴西公共采购的实际问题：

• “过去 7 天内发布的东南部 IT 招标公告中，哪些项目金额超过 50 万雷亚尔？”
• “SP 州是否有适用于 notebook 且仍有余额的有效价格登记协议？”
• “过去 2 年内，CNPJ X 与联邦公共机构签订合同的历史记录是什么？”
• “根据 PCA，Y 市政府今年计划采购什么？”
• “总结这份招标公告，并给我一份可行性核查清单。”

🚀 使用方法

前提条件

• 已安装 Node.js 18 或更高版本（nodejs.org）
• 任意兼容 MCP 的客户端（见下方列表）

无需 API 密钥、无需注册、无需本地数据库 — 服务器会直接查询公共端点。

⚠️ 重要： 这是一个基于 stdio 的 MCP 服务。你不能直接在终端中运行它 — 需要时由 MCP 客户端（Claude Desktop、Cursor 等）调用服务，并通过 stdin/stdout 使用 JSON-RPC 进行通信。如果你直接在终端中运行 npx @licinexusbr/mcp，它看起来会像是“卡住了” — 这是正常的，服务正在等待客户端连接。

同样，npx -y @licinexusbr/mcp 不是全局安装 — 它只会将包下载到本地缓存（~/.npm/_npx/）并运行。每次需要服务时，MCP 客户端都会调用 npx；后续运行会使用缓存，因此会立即启动。（你也可以使用 npm exec 替代 npx — 两者等效。）

---

1. Claude Desktop ⭐（推荐）

路径 A — 通过 UI（Claude Desktop ≥ 4.x）

1. 打开 Claude Desktop
2. Cmd + ,（macOS）或 Ctrl + ,（Windows）→ 设置
3. 侧边栏 → 连接器
4. 点击 “编辑配置”（桌面应用 → 开发者）
5. 在编辑器中打开文件 claude_desktop_config.json

替换（或在 mcpServers 中添加）：

{
  "mcpServers": {
    "licinexus": {
      "command": "npx",
      "args": ["-y", "@licinexusbr/mcp"]
    }
  }
}

6. 保存文件（Cmd+S）
7. 完全退出 Claude（Cmd+Q — 仅关闭窗口还不够），然后重新打开

方案 B — 直接编辑文件

操作系统	路径
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json
Linux	Claude Desktop 暂不正式支持

如何确认已生效

重新打开后，在新对话中：

• 在 设置 → 连接器 → licinexus 中，你应能看到列出的 18 个工具（search_licitacoes、get_cnpj_data 等）
• 在提示词输入框中，输入：

Quais ferramentas do licinexus você tem disponíveis?

Claude 应会列出 18 个工具。现在可以继续了。

用于测试的入门提示词

Me mostra os dados do CNPJ 00000000000191 (Banco do Brasil)

Tem ata de registro de preço vigente para notebook em São Paulo com saldo disponível?

O que a Prefeitura de Juiz de Fora planeja comprar este ano segundo o PCA?

Quais editais de tecnologia da informação foram publicados nos últimos 7 dias acima de R$ 200 mil?

---

2. Cursor

Cursor 原生支持 MCP 服务。创建或编辑文件 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "licinexus": {
      "command": "npx",
      "args": ["-y", "@licinexusbr/mcp"]
    }
  }
}

也可以通过 UI 操作：Cursor → 设置 → MCP → 添加新的 MCP 服务。

重启 Cursor。工具会显示在 Composer 聊天中。

---

3. Continue.dev（VS Code / JetBrains）

编辑文件 ~/.continue/config.json（或 config.yaml）：

{
  "mcpServers": [
    {
      "name": "licinexus",
      "command": "npx",
      "args": ["-y", "@licinexusbr/mcp"]
    }
  ]
}

重新加载 Continue（Cmd+Shift+P → "Continue: Reload"）。工具即可在聊天中使用。

---

4. Cline / Roo Code（VS Code 扩展）

通过 Cline UI 操作：

1. 在 VS Code 侧边栏中打开 Cline 扩展
2. 点击设置图标 → MCP 服务器 → 编辑 MCP 设置
3. 添加：

{
  "mcpServers": {
    "licinexus": {
      "command": "npx",
      "args": ["-y", "@licinexusbr/mcp"]
    }
  }
}

---

5. Zed 编辑器

编辑 ~/.config/zed/settings.json（macOS/Linux）并添加：

{
  "context_servers": {
    "licinexus": {
      "command": {
        "path": "npx",
        "args": ["-y", "@licinexusbr/mcp"]
      }
    }
  }
}

重启 Zed。

---

6. ChatGPT

目前，**ChatGPT 消费者版（Web）**不原生支持 MCP stdio。不过，可以通过以下方式使用：

通过 OpenAI Agents SDK（Python）

from openai import OpenAI
from openai.agents import Agent, MCPServerStdio

server = MCPServerStdio(
    command="npx",
    args=["-y", "@licinexusbr/mcp"]
)

agent = Agent(
    name="Licinexus Assistant",
    instructions="Você é um analista de licitações públicas brasileiras.",
    mcp_servers=[server]
)

ChatGPT Desktop

近期版本提供有限的 MCP 支持——请查看 OpenAI 官方文档，了解当前状态。

---

7. 通过编程方式使用（任何通过 stdio 通信的大模型）

你可以通过 stdio，使用任何支持 MCP JSON-RPC 协议的语言直接调用服务。Node 示例：

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';

const transport = new StdioClientTransport({
  command: 'npx',
  args: ['-y', '@licinexusbr/mcp'],
});

const client = new Client({ name: 'meu-app', version: '1.0.0' }, { capabilities: {} });
await client.connect(transport);

const tools = await client.listTools();
console.log(tools);

const result = await client.callTool({
  name: 'search_atas_rp',
  arguments: { palavraChave: 'notebook', somenteVigentes: true },
});

---

🔧 故障排除

“Server failed to start”或“command not found: npx”

原因： Claude Desktop / 其他客户端无法在 PATH 中找到 npx。

解决方案： 使用绝对路径。通过以下命令查找：

which npx

然后在配置中替换：

{
  "mcpServers": {
    "licinexus": {
      "command": "/opt/homebrew/bin/npx",
      "args": ["-y", "@licinexusbr/mcp"]
    }
  }
}

“保存配置后未显示工具”

解决方案： 完全重启客户端。在 Mac 上，使用 Cmd+Q 退出（仅关闭窗口还不够）。MCP 服务只会在启动时加载。

“EACCES”或权限错误

原因： npx 缓存损坏或缺少写入权限。

解决方案：

npm cache clean --force
npx -y @licinexusbr/mcp

执行的是旧版本

原因： npx 会保留缓存。若要强制使用最新版本：

npx -y @licinexusbr/mcp@latest

并在配置中使用：

"args": ["-y", "@licinexusbr/mcp@latest"]

大型查询超时

某些查询（宽泛的关键词搜索、较长的日期范围）可能需要较长时间——PNCP 有时需要 15-30 秒才能响应。服务已实现重试预算。如果问题仍然存在，请使用更具体的筛选条件来缩小查询范围。

日志和调试

若要检查请求/响应，请在终端中手动运行：

LICINEXUS_LOG_LEVEL=debug npx -y @licinexusbr/mcp

然后在另一个窗口中，观察客户端发起调用时的日志。

错误消息的语言

默认情况下，工具返回的错误消息为葡萄牙语。若要接收英文错误消息：

LICINEXUS_LANG=en npx -y @licinexusbr/mcp

可接受的值：pt（默认）或 en。

工具（18）

采购 / 招标

工具	功能
search_licitacoes	按日期、招标方式、州、机构 CNPJ、金额、关键词搜索招标公告
get_licitacao	根据 PNCP 控制编号获取招标公告的完整详情
list_licitacao_itens	招标公告的项目（标段）：描述、数量、金额
list_licitacao_resultados	按项目查看招标结果：中标者、价格、供应商
list_licitacao_arquivos	招标公告文件（PDF、附件、参考条款）

合同

工具	功能
search_contratos	按日期、机构、供应商、金额搜索合同
get_contrato	获取合同的完整详情
list_contrato_termos	补充条款（延期、金额 / 期限变更）
list_contrato_instrumentos	收款凭证（NFes、发票）

价格登记记录

工具	功能
search_atas_rp	搜索 RP 记录 —— 默认仅搜索有效记录。查找可使用的合同。
get_ata_rp	获取记录的完整详情 + 项目（含可用余额）+ 文件

机构 / 供应商 / PCA

工具	功能
get_orgao	公共机构资料（权力、层级、法律性质）
get_fornecedor_contratos	某个 CNPJ 作为供应商所涉及的公共合同
search_pca	年度采购计划 —— 提前了解将要采购的内容
list_pca_itens	特定 PCA 中的计划项目

CNPJ 信息补充

工具	功能
get_cnpj_data	通过 BrasilAPI（默认）或 MinhaReceita（CNPJ_PROVIDER=minhareceita）获取联邦税务局登记信息（CNAEs、股东、资本、状态）

汇总分析（v0.2.0）

工具	功能
aggregate_licitacoes_por_periodo	最长 5 年时间窗口内的数量时间序列（可选包含金额），按日 / 周 / 月 / 年分组。可按招标方式、州、城市、CNPJ、政府层级筛选
compare_periodos	并排比较两个时期，返回总计 + 绝对值和百分比变化。适用于“选举年是否提前采购？”之类的问题

预置提示词（4 个）

助手可直接调用的预构建工作流：

提示词	功能
analyze_edital	招标公告可行性检查清单
analyze_orgao	公共机构 360° 概况
find_arp_opportunities	查找指定关键词对应的有效框架协议及可用余额
check_supplier	基于公开数据对供应商 CNPJ 进行基本核验

资源（2 个）

URI	内容
licitacao://modalidades	PNCP 招标方式参考表（第 14.133 号法律）
licinexus://scope	本 MCP 的功能与非功能范围

会话示例

Você:   Tem alguma ata de registro de preço vigente para notebooks?
Claude: [chama search_atas_rp com palavraChave="notebook", somenteVigentes=true]
        Encontrei 12 atas vigentes mencionando notebooks. As 3 mais relevantes:
        1. Ministério da Justiça — vigência até 2026-12-31, valor estimado R$ 2,4M
        2. Prefeitura de São Paulo — vigência até 2026-09-30...

Você:   Detalhes da primeira, com saldos por item?
Claude: [chama get_ata_rp includeItens=true]
        - Item 1: Notebook tipo I (16GB RAM, 512GB SSD) — saldo 1.200 unid, R$ 4.800/un
        - Item 2: Notebook tipo II ...

演进路线图

• 阶段 0 — 结构、治理、CI
• 阶段 1 — 招标（5 个工具）
• 阶段 2 — 合同 + 补充条款 + 发票（4 个工具）
• 阶段 3 — 注册价格记录（2 个工具）
• 阶段 4 — 机构 + 供应商 + PCA（4 个工具）
• 阶段 5 — CNPJ + 4 个提示词 + 2 个资源（1 个工具）
• 针对真实 API 的冒烟测试（15/15 个端点）
• 阶段 6 — 公开发布（11/05/2026 · npm 上的 v0.1.0）
• 阶段 7 — 社区适配器（各州 TCE/TCM、旧版 ComprasNet）

范围

本 MCP 的功能

• 封装巴西政府的公共 API（PNCP、BrasilAPI）。
• 返回结构化原始数据——由大模型进行分析。
• 对较大的响应保留本地缓存（内存中的 LRU，较短的 TTL）。

本 MCP 不具备的功能

• 不查询 Licinexus 的任何私有基础设施或数据库。
• 不包含匹配引擎（matchmaking）、供应商评分、价格汇总、AI 生成的内容或 Licinexus 的任何专有数据。
• 不替代 Licinexus 产品——它是一个用于相同数据公共层的配套开源工具。

完整的三层隔离模型请参阅 docs/architecture.md。

需要自动匹配、提醒或提案管理功能？

Licinexus 产品基于这些相同的公共数据源构建，并提供专有匹配引擎、智能评分和 AI 生成的内容。本 MCP 有意不复刻这些功能。

→ https://licinexus.com.br

如何贡献

欢迎按照 DCO（Developer Certificate of Origin）提交 PR——请使用 git commit --signoff 为提交签名。

对于任何非简单的变更，请先创建 issue进行讨论。请参阅 CONTRIBUTING.md。

支持

社区项目。**尽力而为，不提供 SLA。**在条件允许时，issue 会在 7 天内进行分类处理。

如需付费支持和产品功能，请访问 licinexus.com.br。

安全

发现漏洞？请参阅 SECURITY.md 了解负责任的披露流程（请勿创建公开 issue）。

许可证

MIT © Licinexus。请参阅 LICENSE。