适合谁
- 需要查询巴西公共采购公开数据的 LLM 用户与分析人员
- 使用 Claude Desktop、Cursor、Continue、Cline/Roo Code 或 Zed 的开发者
- govtech、合规、供应商情报与招投标研究人员
- 希望免密钥、免注册直接调用 PNCP 与 CNPJ 公开数据的团队
L
46FMRS · D
这是一个聚焦巴西公共采购与 CNPJ 公开数据的开源 MCP 服务器，功能覆盖招标、合同、价格登记表、机构、PCA、供应商与聚合分析，共 18 个工具、4 个提示词、2 个资源。它免密钥、免注册，安装配置简单，适合分析人员和开发者做公开数据查询；不提供 Licinexus 的专有匹配与评分功能，也无官方 SLA，数据准确性依赖上游公开接口。
Licinexus MCP 服务器由 Licinexus 维护，以 MIT 许可证开源发布，通过 npm 包 @licinexusbr/mcp 以 stdio 方式提供。它把巴西 Portal Nacional de Contratações Públicas（PNCP，国家公共采购门户）以及巴西联邦税务局（Receita Federal）CNPJ 企业注册数据的公开端点封装成 18 个工具、4 个提示词和 2 个资源，让 Claude Desktop、Cursor、Continue、Cline/Roo Code、Zed 等 MCP 客户端用自然语言查询招标公告、合同、价格登记表（ata de registro de preço）、公共机构、年度采购计划（PCA）、供应商合同以及企业注册信息。服务器只返回结构化的原始公开数据，由 LLM 负责分析；不包含 Licinexus 的专有匹配引擎、供应商评分或 AI 生成产物。无需 API 密钥、无需注册、无需本地数据库，数据直接来自公开接口（PNCP 与 BrasilAPI，CNPJ 数据源可用环境变量在 brasilapi 与 minhareceita 之间切换）。
工具能力
search_licitacoes
按日期、采购方式、州（UF）、机构 CNPJ、金额、关键词检索招标公告
get_licitacao
按 PNCP 控制编号获取某个招标公告的完整详情
list_licitacao_itens
列出招标公告的物品（标包）：描述、数量、金额
list_licitacao_resultados
按物品列出竞标结果：中标方、价格、供应商
list_licitacao_arquivos
获取招标公告文件（PDF、附件、技术任务书）
search_contratos
按日期、机构、供应商、金额检索合同
get_contrato
获取某份合同的完整详情
list_contrato_termos
列出合同附加条款（延期、金额/期限变更）
list_contrato_instrumentos
列出收款凭证（发票、账单）
search_atas_rp
检索价格登记表——默认仅返回有效期内记录，用于发现仍可使用的合同
get_ata_rp
获取价格登记表完整详情，包括物品（含可用余额）与文件
get_orgao
公共机构档案（权力分支、层级、法人性质）
get_fornecedor_contratos
某 CNPJ 作为供应商签订的公共合同
search_pca
年度采购计划（PCA）——提前了解将采购什么
list_pca_itens
某个 PCA 的规划采购物品
get_cnpj_data
通过 BrasilAPI（默认）或 MinhaReceita 获取联邦税务局企业注册信息（CNAE、股东、资本、状态）
aggregate_licitacoes_por_periodo
最长 5 年窗口内招标数量的时间序列（可选金额），支持按日/周/月/年分桶；可按采购方式、UF、市、CNPJ、政府层级筛选
compare_periodos
并排比较两个时期，返回总量以及绝对和百分比差值
安装接入
- 确认已安装 Node.js 18 或更高版本。2. 在 MCP 客户端配置文件中添加 licinexus 服务器。以 Claude Desktop 为例：打开 设置 → 连接器 → 编辑配置，编辑 claude_desktop_config.json（macOS 路径 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 路径 %APPDATA%\Claude\claude_desktop_config.json），在 mcpServers 中加入 {"licinexus": {"command": "npx", "args": ["-y", "@licinexusbr/mcp"]}}。3. 保存文件并完全退出并重启客户端（macOS 需 Cmd+Q，关闭窗口不够）。4. 在 设置 → 连接器 → licinexus 中确认列出 18 个工具。Cursor 使用 ~/.cursor/mcp.json，Continue 使用 ~/.continue/config.json，Zed 使用 ~/.config/zed/settings.json 的 context_servers 字段。注意这是 stdio 服务器，直接在终端运行 npx @licinexusbr/mcp 会看似“卡住”，这是正常现象——它在等待客户端通过 stdin/stdout 用 JSON-RPC 连接。
claude_desktop_config.json
{
"mcpServers": {
"licinexus": {
"command": "npx",
"args": ["-y", "@licinexusbr/mcp"]
}
}
}
选型与风险
不适合谁
- 需要 Licinexus 专有匹配引擎、供应商评分、价格聚合或 AI 生成产物的用户
- 需要官方 SLA 或付费支持的场景（本项目为社区项目，尽力而为、无 SLA）
- 期望访问私有数据库或非公开数据的用户
- 目前不支持 MCP stdio 的 ChatGPT 网页版用户
所需权限
- 网络访问：调用 PNCP、BrasilAPI（或 MinhaReceita）等公开 HTTPS 端点
- 本地执行：通过 npx 下载并运行 npm 包 @licinexusbr/mcp，使用本地 npm 缓存目录（如 ~/.npm/_npx/）
- 进程通信：通过 stdin/stdout 使用 JSON-RPC 与 MCP 客户端通信
- 本地内存缓存：对较重响应做 LRU 内存缓存，TTL 较短
- 可选环境变量：CNPJ_PROVIDER（brasilapi 默认或 minhareceita）、LICINEXUS_LOG_LEVEL、LICINEXUS_LANG
- 不需要 API 密钥或账号凭据
风险与副作用
- 数据来自政府公开接口，PNCP 响应有时需 15–30 秒，宽泛查询可能超时
- 公开数据可能存在延迟、缺失或不一致，LLM 输出需人工复核，不应作为法律或投标决策的唯一依据
- npx 会从 npm 拉取并执行第三方包，供应链风险取决于该包发布渠道的可信度
- npx 缓存可能导致运行旧版本，需显式指定 @latest
- 配置文件中若暴露本机绝对路径（如 which npx 的结果）会写入本地配置
- 调试日志可能包含查询参数，注意不要泄露敏感上下文
常见排障
- 提示 ‘Server failed to start’ 或 ‘command not found: npx’：客户端找不到 PATH 中的 npx，用 which npx 取得绝对路径并写入配置的 command
- 保存配置后工具不出现：完全重启客户端（macOS 用 Cmd+Q），MCP 服务器仅在启动时加载
- 出现 EACCES 或权限错误：执行 npm cache clean --force 后重试 npx -y @licinexusbr/mcp
- 运行的是旧版本：改用 args ["-y", "@licinexusbr/mcp@latest"]
- 大查询超时：PNCP 可能较慢，服务器已内置重试预算，建议用更精确的过滤条件
- 需要日志：以 LICINEXUS_LOG_LEVEL=debug 运行；错误消息语言可用 LICINEXUS_LANG=en 切换为英文
- 在终端直接运行看似卡住：属正常现象，stdio 服务器在等待客户端连接
使用场景
问‘最近 7 天东南部地区金额超过 50 万雷亚尔的 IT 招标有哪些？’
查询某个关键词在某个州是否还有有效的价格登记表（ata de registro de preço）剩余额度
查询某 CNPJ 过去两年与联邦机构的合同历史
按 PCA 了解某市政府今年计划采购什么
对某份招标公告做可行性检查清单并给出摘要
对两个时期做招标数量和金额的对比分析，例如判断选举年是否出现采购前置
支持客户端
Claude Desktop完整支持
Cursor完整支持
Continue.dev完整支持
Cline完整支持
Roo Code完整支持
Zed完整支持
ChatGPT Desktop部分支持