Juris Licita MCP

Juris Licita MCP

英文摘要。 juris-licita-mcp 是一个面向巴西律师和公共采购投标人的开源 Model Context Protocol 服务。一行命令即可运行：npx juris-licita-mcp。免费且无需密钥：提供按法院和司法辖区计算的程序期限，并考虑法院假日（CPC、CLT、DJEN 发布规则、电子送达、期限加倍、年末休庭），同时列出每个跳过日期的来源；法定期限目录、工作日计算、巴西中央银行官方指数及通胀调整、PNCP 的开放招标、CPF/CNPJ 校验和验证（本地）、邮政编码和基本企业数据。高级工具（按律师协会注册号查询 DJEN 法院公告、诉讼案件、AI 招标分析、采购方评分、律师查询、不动产）通过代理连接到 BitBusca 远程 MCP，需要 BITBUSCA_API_KEY（使用虚构数据的免费测试密钥）。不收集个人数据，也不进行遥测。采用 MIT 许可证。下方文档为葡萄牙语。

直接在 Claude、Cursor 或 VS Code 中查询司法辖区法院假日对应的期限、开放招标和货币调整。 适用于律师和投标人。一行即可安装，无需注册，无需密钥。

_{通过 MCP 协议（stdio）直接调用 contar_dias_uteis 工具，中间不经过 AI 客户端，使用脚本 docs/demo-chamada.mjs。在 Claude、Cursor 或 VS Code 中，结果相同。 录制时使用的版本为 0.1.0；输出是工具的实际结果。}

npx juris-licita-mcp

---

可以询问什么

法律业务

• “DJEN 于 2026 年 11 月 13 日发布了针对 Campo Grande 的 TJMS 案件的送达通知。15 个工作日的期限何时届满？请列出未计入的日期。”
• “CPC 中答辩的期限是多久？CLT 中普通上诉的期限呢？”
• “政府部门于 2026 年 3 月 2 日收到电子送达通知，但没有打开。期限加倍后的 15 天期限何时届满？”
• “TJSP 12 月有哪些法院假日？”
• “将 25,000 雷亚尔从 2021 年 3 月起按 IPCA-E 调整至今，按年列出。”

招标

• “Mato Grosso do Sul 有开放的学校供餐电子竞标吗？哪些会在周五前截止？”
• “列出 Campo Grande（IBGE 5002704）最近发布的开放招标公告。”
• “异议期限为开标前 3 个工作日，开标日期是 2026 年 11 月 24 日。我最迟何时可以提出异议？”
• “这个 CNPJ 有效吗？12.ABC.345/01DE-35”（是的，这是 2026 年的字母数字 CNPJ）
• “查询 CNPJ 11.222.333/0001-81 的状态、CNAE 和企业规模。”

使用 BitBusca 密钥（高级模式）：

• “本周 OAB 123456/SP 收到了哪些送达通知？总结最新的一条并计算期限。”
• “整理案件 0000000-00.2026.8.12.0001 的档案。”
• “找出金额超过 50 万雷亚尔的医院清洁招标，并分析第一条：我需要提交哪些文件？”

安装

需要 Node.js 20 或更高版本。无需其他依赖。

Claude Code

claude mcp add juris-licita -- npx -y juris-licita-mcp

使用高级模式：

claude mcp add juris-licita -e BITBUSCA_API_KEY=bk_test_SUA_CHAVE -- npx -y juris-licita-mcp

使用 --scope user，即可在所有项目中使用。

Claude Desktop

在设置 → 开发者 → 编辑配置（claude_desktop_config.json）中：

{
  "mcpServers": {
    "juris-licita": {
      "command": "npx",
      "args": ["-y", "juris-licita-mcp"],
      "env": { "BITBUSCA_API_KEY": "" }
    }
  }
}

将 BITBUSCA_API_KEY 留空，即可只使用免费功能。重新启动 Claude Desktop。

Windows： 如果 Claude Desktop 找不到 npx，请使用 "command": "cmd" 和 "args": ["/c", "npx", "-y", "juris-licita-mcp"]。

Cursor

配置文件为 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目内）：

{
  "mcpServers": {
    "juris-licita": {
      "command": "npx",
      "args": ["-y", "juris-licita-mcp"],
      "env": { "BITBUSCA_API_KEY": "" }
    }
  }
}

VS Code（Copilot Chat，代理模式）

文件 .vscode/mcp.json。VS Code 首次使用时会询问密钥并安全保存（可以留空）：

{
  "inputs": [
    { "type": "promptString", "id": "bitbusca-key", "description": "Chave BitBusca (opcional, liga o modo avançado)", "password": true }
  ],
  "servers": {
    "juris-licita": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "juris-licita-mcp"],
      "env": { "BITBUSCA_API_KEY": "${input:bitbusca-key}" }
    }
  }
}

任何其他 MCP 客户端（HTTP）

npx juris-licita-mcp --http            # http://127.0.0.1:3333/mcp (Streamable HTTP, sem sessão)
npx juris-licita-mcp --http --port 8080

在 HTTP 模式下，每个请求的 Authorization: Bearer bk_… 标头就是该请求的密钥。默认情况下只监听 127.0.0.1，并启用 DNS rebinding 防护，每个 IP 每分钟最多调用 60 次。如果要将其暴露到互联网，请在前面放置一个带 TLS 的代理。

免费 × 高级

工具	功能	免费，无需密钥	来源
calcular_prazo	诉讼期限到期日，附分步说明：CPC、CLT、自然日、DJEN（发布 → 正式刊载）、电子送达及推定知悉、期限加倍、司法休庭期、法院及市镇辖区的司法假日，并列出每个跳过日期及其来源	是	prazos-br（本地）
prazos_da_lei	某项诉讼行为（答辩、上诉、异议……）的期限天数、计算方式及法律依据	是	prazos-br 目录
feriados	全国法定假日（附法律依据）或某个法院／市镇辖区的完整司法日历	是	prazos-br
contar_dias_uteis / somar_dias_uteis	按司法、全国或银行日历计算工作日，并说明哪些日期未计入及原因	是	prazos-br
tribunais_cobertos	哪些法院有完整司法日历，以及覆盖哪些年份	是	prazos-br
indice_economico	SELIC（日利率和目标利率）、CDI、IPCA、IPCA-E、INPC、IGP-M、美元；期间累计值及 12 个月累计值	是	巴西中央银行（SGS，公共 API）
corrigir_valor	按 IPCA、IPCA-E、INPC、IGP-M 或 SELIC 进行简单货币调整，采用 Calculadora do Cidadão 的计算惯例	是	巴西中央银行（SGS）
editais_abertos	正在接受报价的招标：关键词、UF、市镇（IBGE）、方式、期限、链接	是	PNCP（公开搜索）
validar_documento	CPF 和 CNPJ 校验码（包括 2026 年的字母数字 CNPJ）。本地计算，不查询任何机构；CPF 返回时会打码	是	本地计算
consultar_cep	CEP 地址	是，每日限额*	BitBusca
consultar_cnpj	CNPJ 公共登记信息（状态、CNAE、企业规模、地址、Simples／MEI），不含股东	是，每日限额*	BitBusca（巴西税务局公开数据）
buscar_publicacoes_djen、ler_publicacao	按 OAB、案件、当事人或关键词查询《全国电子司法公报》中的送达通知和公告	需密钥	BitBusca
criar_monitor_djen	每当某个 OAB、当事人或案件有新公告时，通过 webhook 通知	需密钥	BitBusca
ficha_processo	案件封面信息和进展记录	需密钥	BitBusca
ficha_advogado	按 OAB 查询律师公开档案，不含联系方式	需密钥	BitBusca
buscar_editais_bitbusca、ler_edital	查询 PNCP 和其他门户的招标公告，可按金额和期限筛选	需密钥	BitBusca
analisar_edital、resumo_edital	Bitinho 阅读招标公告：文件清单、期限、风险，并为每项标注来源页码	需密钥（会事先显示费用）	BitBusca
score_orgao	按公共财政数据规则对采购机构评分（0 到 100；该机构通常是否按时付款？），并说明理由及各项来源	需密钥（1 个额度；技术故障不收费）	BitBusca（巴西国家财政部、透明门户、PNCP）
buscar_empresas	按 UF、市镇、CNAE、企业规模和成立时间查询企业，不含股东	需密钥	BitBusca
cidades_imovel、buscar_imovel、ficha_imovel	市镇房地产登记信息（覆盖的城市），不含所有者	需密钥	BitBusca
meu_saldo	套餐和额度余额	需密钥	BitBusca

* 无需密钥时，CEP 和 CNPJ 查询使用 BitBusca 公共查询服务，每个连接有每日限额：300 个 CEP 和 50 个不同的 CNPJ。CNPJ 数据仅来自自有数据库（巴西税务局公开登记信息），不含股东、电话或电子邮件；对于 MEI 和个体企业，地址仅显示街区、城市和 UF。连续查询 CNPJ（根号 +1、+2……）会暂停该连接 24 小时内的免密钥查询。达到限额后，工具会说明情况；若提供了密钥，则改用密钥查询（使用密钥时，CEP 免费，CNPJ 每次需 1 个额度）。

无需密钥时，所有高级工具都会正常响应，说明其功能以及如何启用。不会有任何功能出错。

司法日历覆盖范围

完整的司法日历（年度公告、市政节假日、可选休假日、司法休庭期）来自 prazos-br，目前覆盖 22 个法院：TJSP、TJRJ、TJMG、TJRS、TJPR、TJSC、TJBA、TJGO、TJPE、TJDFT 和 TJMS；TRF1、TRF2、TRF4、TRF5 和 TRF6；TRT1、TRT2、TRT3、TRT4、TRT15 和 TRT24。大多数法院覆盖首府或所在地的市政节假日；TJMS 和 TRT24 还覆盖内陆地区。各年份的覆盖范围见 COBERTURA.md。对于其他法院，计算会使用全国性节假日、司法休庭期以及 12/20 至 1/20 的暂停期限（CPC 第 220 条），并会在回复中提醒实际到期日可能更晚。其他法院即将加入；格式开放，欢迎通过 prazos-br 贡献。询问 AI“覆盖了哪些法院？”即可查看当前列表。

高级模式（BitBusca 密钥）

1. 在 bitbusca.net/desenvolvedor 创建密钥。
   • 测试密钥（bk_test_…）：免费，无有效期限制，返回虚构数据。适合配置和测试。
   • 沙盒：提供 7 天免费额度，数据真实。
   • 套餐：每月额度；请查看 bitbusca.net/desenvolvedores。
2. 在 MCP 配置中将密钥设为 BITBUSCA_API_KEY，然后重启 AI 应用。

高级工具会将调用转发至 BitBusca 的官方 MCP，使用 企业配置文件（https://api.bitbusca.net/api/v1/mcp/empresas），与连接器目录使用相同的配置：不会以自然人作为主要结果，凭证仅放在请求头中。

计费方式

• 技术故障不收费；“无记录”会收费。 如果查询因我们或数据源的错误而未能完成，不会消耗额度。如果查询已完成但没有找到记录，这仍是有效回复（数据库已查询），费用相同。
• AI 分析会预先显示费用。 不带 confirmar 调用 analisar_edital 和 resumo_edital 时，只会返回额度费用、余额，以及你是否已为该分析付费（免费）。只有设置 confirmar: true 才会执行并收费；每份公告每 30 天只收费一次。
• 测试密钥永不收费。

隐私与规则

• 免费工具不会提供任何自然人数据。 validar_documento 只会校验号码的数学有效性。consultar_cnpj 不会提供股东、电话或电子邮件；对于 MEI 和个体经营者，地址只会显示街区、城市和州；文本中看起来像 CPF 的数字序列会转换为 ***.***.***-**。高级工具使用企业配置文件，由服务器端过滤自然人数据（司法公告会保留官方公报上公布的姓名）。
• 无遥测。 服务不会统计使用情况，也不会向被调用工具所需的数据源（Banco Central、PNCP 或 BitBusca）以外的任何地方发送数据。期限、节假日和校验均 100% 在你的设备上运行。由于不会收集任何数据，因此无需关闭任何功能。请求会携带 User-Agent: juris-licita-mcp/<versão>，以便数据源识别调用方。
• 遵守公共数据源的使用规范。 使用内存缓存（索引：6 小时；公告：10 分钟；CEP/CNPJ：最长 24 小时），对每个数据源逐个发送请求并保持最小间隔，遇到 429 时遵循 Retry-After 进行退避。不会进行扫描。
• 错误消息简明易懂。 不显示堆栈或技术细节。如需在本地诊断，请使用 JURIS_LICITA_MCP_DEBUG=1 运行（信息只会输出到本地 stderr）。

环境变量

变量	默认值	用途
BITBUSCA_API_KEY	(空)	启用高级模式
BITBUSCA_API_URL	https://api.bitbusca.net/api	API 基础地址（CEP/CNPJ）
BITBUSCA_MCP_URL	…/v1/mcp/empresas	高级模式的远程 MCP 服务
JURIS_LICITA_MCP_HTTP_HOST / JURIS_LICITA_MCP_HTTP_PORT	127.0.0.1 / 3333	--http 模式
JURIS_LICITA_MCP_DEBUG	(空)	在 stderr 中进行诊断

注意事项

• 期限仅为辅助计算。 请务必在案件中核实；它不能替代专业核查。政府令可能在年内变更（因系统故障暂停、新增非办公日）：如果法院、司法辖区或年份尚未收录，回复中会提示。
• 货币调整采用简单计算（不含利息、罚款或律师费），仅供核对。需要包含 PDF 计算明细的完整司法计算，请访问：bitbusca.net/calculos。
• 数据在查询时取自官方来源；每条回复都会注明来源。

相关项目

• prazos-br：此处使用的期限和司法日历库（TypeScript，MIT）。可直接在你的系统中使用。
• mcp-brasil：用于获取巴西的一般公共数据，mcp-brasil 将数十个公共 API 汇集到一个服务中，是很好的补充。两者可以并行运行：它覆盖广泛领域；Juris Licita MCP 专注于诉讼期限、DJEN 和招标。

开发

git clone https://github.com/bitbusca/juris-licita-mcp && cd juris-licita-mcp
npm install
npm run build
npm test                 # node:test, sem rede (fixtures e mocks)
npm run inspector        # MCP Inspector apontando para dist/index.js

在不发布的情况下使用 Claude Code 测试：

claude mcp add juris-licita-local -- node /caminho/para/juris-licita-mcp/dist/index.js

结构：src/ferramentas/（每个主题一个），src/servidor.ts（工具注册），src/index.ts（stdio 和 HTTP），test/（使用从真实数据中截取的 fixtures 进行测试，位于 test/fixtures/）。

欢迎贡献：进行重大更改前请先提交 issue。新增法院日历请提交到 prazos-br；新的免费工具（必须基于公共数据且不涉及自然人）请提交到此项目。

许可证

MIT。由 BitBusca 制作。