Licinexus Mcp

🇧🇷 Português · 🇺🇸 英語版

@licinexusbr/mcp

ブラジルの公共入札データに会話形式でアクセスできます。Claude Desktop、Cursor、Continue、またはMCP対応クライアントから直接利用できます。

ブラジルの govtech エコシステムへのオープンソース貢献として、Licinexus がメンテナンスしています。

🔔 新しいバージョンの通知を受け取りたいですか？ リポジトリ上部の Watch → Custom → Releases をクリックしてください。新しいリリースが公開されるたびに通知が届き、フィードが埋もれることもありません。

📺 上記のデモは、LLMが使用するものと同じアダプターを呼び出すCLIスクリプトで、PNCPとBrasilAPIのライブデータを利用しています。Claude Desktop／Cursorでの操作も同じです。同じツール、同じデータを使い、LLMが自然言語で解釈します。

---

できること

**公共調達の全国ポータル（PNCP）**の便利なエンドポイントと、**連邦歳入庁（Receita Federal）**のCNPJデータをまとめ、LLMがブラジルの公共調達に関する実際の質問に回答できるようにします。

• 「過去7日間に公開された、南東部の50万レアルを超えるIT入札公告はありますか？」
• 「SP州でnotebookの残高がある有効な価格登録契約はありますか？」
• 「CNPJ Xが過去2年間に連邦政府機関と結んだ契約の履歴を教えてください。」
• 「Y市役所はPCAによると今年何を購入する予定ですか？」
• 「この入札公告を要約して、実施可能性のチェックリストを作成してください。」

🚀 使用方法

前提条件

• 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を呼び出します。2回目以降の実行ではキャッシュが使われるため、すぐに起動します。npxの代わりにnpm execも使用できます。どちらも同じ動作です。

---

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 — ファイルを直接編集する

OS	パス
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 → Settings → MCP → Add new MCP server を選択します。

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 Servers → Edit MCP Settings を選択します
3. 次を追加します。

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

---

5. Zed editor

~/.config/zed/settings.json（macOS/Linux）を編集して、次を追加します。

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

Zed を再起動します。

---

6. ChatGPT

ChatGPT consumer（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 経由で任意の LLM）

MCP の JSON-RPC プロトコルに対応する言語であれば、stdio 経由でサーバーを直接呼び出せます。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	日付、方式、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	請求書類（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）経由で取得する連邦歳入庁の登録情報（CNAE、株主、資本金、状況）

集計分析（v0.2.0）

ツール	内容
aggregate_licitacoes_por_periodo	最長5年間の期間における件数（任意で金額も）の時系列データを、日／週／月／年単位で集計します。方式、UF、市区町村、CNPJ、政府の行政区分で絞り込めます
compare_periodos	2つの期間を並べて比較し、合計と絶対値およびパーセンテージの差を返します。「選挙の年に前倒しがあったか」のような質問に役立ちます

既定のプロンプト（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 — 契約＋変更契約＋NFes（ツール4件）
• フェーズ3 — RP枠組み契約（ツール2件）
• フェーズ4 — 機関＋仕入先＋PCA（ツール4件）
• フェーズ5 — CNPJ＋プロンプト4件＋リソース2件（ツール1件）
• 実際のAPIに対するスモークテスト（エンドポイント15/15件）
• フェーズ6 — 一般公開（2026/05/11 · npmでv0.1.0）
• フェーズ7 — コミュニティアダプター（州のTCE/TCM、従来のComprasNet）

対象範囲

このMCPが行うこと

• ブラジル政府の公開API（PNCP、BrasilAPI）をラップします。
• 構造化された生データを返し、分析はLLMが行います。
• 大容量の応答をローカルキャッシュに保存します（メモリ内LRU、短いTTL）。

このMCPが行わないこと

• Licinexusの非公開インフラやデータベースには一切アクセスしません。
• マッチングエンジン、仕入先スコアリング、価格集計、AI生成アーティファクト、その他のLicinexus独自データは含まれません。
• Licinexus製品の代替ではありません。同じデータの公開レイヤーを対象とする、補完的なオープンソースツールです。

3つの壁による分離モデルの全容については、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をご覧ください。