secop-mcp-server

SECOP MCP Server

SECOP I および SECOP II を通じて、コロンビアの公共調達を検索する MCP（Model Context Protocol） サーバーです。

データは datos.gov.co（Socrata の SODA API）からリアルタイムで取得され、すべて公開されています。ローカルにデータを保存することはありません。

何に使えますか？

このサーバーを使うと、Claude などの言語モデルがコロンビア国家の公共調達データを直接検索できます。これにより、次のことが容易になります。

• 政治的監視： 公共機関や公務員の契約を調査します。
• 透明性： 契約業者、金額、契約方式を確認します。
• データジャーナリズム： 供給業者と機関の情報を照合します。
• 市民による監視： 誰でも、公的資金がどのように使われているかを調べられます。

利用可能なデータセット

データセット	説明	出典
SECOP I - プロセス	公共調達プロセスの過去データ	datos.gov.co
SECOP II - プロセス	取引型の調達プロセス	datos.gov.co
SECOP II - 契約	支払い済み／請求済み金額を含む電子契約	datos.gov.co
SECOP II - 供給業者	プラットフォームに登録されている供給業者	datos.gov.co

ツール

ツール	説明
buscar_secop1	機関、契約業者、目的、県、日付範囲などで SECOP I のプロセスを検索します。
buscar_procesos_secop2	時間に関するフィルターを使って SECOP II の調達プロセスを検索します。
buscar_contratos_secop2	時間に関するフィルターを使って SECOP II の電子契約を検索します。
buscar_proveedores	SECOP II に登録されている供給業者を検索します。
buscar_por_persona	身分証明書番号／NIT または人物名で、すべてのデータセットを検索します。
resumen_contratacion	契約の要約ビューです（主なフィールド：機関、供給業者、金額、ステータス、日付）。
agregaciones_contratacion	供給業者、機関、県、または方式ごとに集計した合計を表示します。
consulta_libre	任意のデータセットに対する高度な SoQL クエリです。
listar_datasets	すべてのデータセットと利用可能なフィールドを表示します。

インストール

要件

• Python 3.11+
• uv（推奨）または pip

オプション 1：PyPI から（推奨）

# Con uv (más rápido)
uvx secop-mcp-server

# Con pip
pip install secop-mcp-server

オプション 2：GitHub から

uvx --from git+https://github.com/juandavidsernav/secop-mcp-server secop-mcp

オプション 3：ソースコードから

git clone https://github.com/juandavidsernav/secop-mcp-server.git
cd secop-mcp-server
uv sync

設定

Claude Code

# Instalación rápida desde PyPI
claude mcp add secop-colombia -- uvx secop-mcp-server

# O desde código fuente
claude mcp add secop-colombia -- uv run --directory /ruta/al/secop-mcp-server secop-mcp

Claude Desktop

設定ファイルを編集します。

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "secop-colombia": {
      "command": "uvx",
      "args": ["secop-mcp-server"]
    }
  }
}

アプリトークン（任意ですが推奨）

トークンなしでも動作しますが、レート制限が厳しくなります（1 時間あたり約 60 リクエスト）。無料で取得できます。

1. datos.gov.co に登録します。
2. プロフィール > Developer Settings に移動します。
3. 新しいアプリトークンを作成します。

環境変数として設定します。

{
  "mcpServers": {
    "secop-colombia": {
      "command": "uvx",
      "args": ["secop-mcp-server"],
      "env": {
        "SOCRATA_APP_TOKEN": "tu-token-aqui"
      }
    }
  }
}

使用例

設定が完了したら、Claude に次のように依頼できます。

• 「ボゴタ市役所の 10 億ペソを超える契約を検索して」
• 「身分証明書番号 12345678 の人物が結んでいる契約は？」
• 「アンティオキア県の公開入札プロセスを表示して」
• 「今年の SECOP II で最も金額の大きい契約は？」
• 「XYZ 社に関連するすべての契約を検索して」
• 「メデジン市がサービス提供契約にいくら支出したか教えて」
• 「2024 年の EPM の契約を要約して」
• 「アンティオキア県で最も多くの契約を持つ供給業者は？」
• 「メデジン市役所の契約を方式別に集計して」
• 「2025 年 1 月から 3 月の間にバジェ・デル・カウカ県で締結された契約を表示して」

プロジェクト構成

secop-mcp-server/
├── secop_mcp/
│   ├── __init__.py    # Documentación del paquete
│   ├── server.py      # Servidor MCP y definición de herramientas (tools)
│   ├── client.py      # Cliente HTTP para la API SODA de Socrata
│   └── datasets.py    # Catálogo de datasets SECOP y sus metadatos
├── pyproject.toml     # Configuración del paquete Python
├── LICENSE            # Licencia MIT
└── README.md          # Este archivo

仕組み

Claude (LLM) <--MCP/stdio--> secop-mcp-server <--HTTP/SoQL--> datos.gov.co (API SODA)

1. Claude が MCP ツール（例：buscar_contratos_secop2）を呼び出します。
2. サーバーが、指定されたフィルターを使って SoQL クエリを作成します。
3. data.gov.co の API に HTTP リクエストが送信されます。
4. 結果が読みやすいテキストに整形され、Claude に返されます。
5. Claude がデータを分析し、ユーザーに回答します。

すべてお使いのマシン上でローカルに実行されます。中間サーバーはなく、データも保存されません。

貢献

貢献を歓迎します。

1. リポジトリをフォークします
2. 機能用のブランチを作成します（git checkout -b feature/nueva-funcionalidad）
3. 変更をコミットします（git commit -m 'Agrega nueva funcionalidad'）
4. ブランチにプッシュします（git push origin feature/nueva-funcionalidad）
5. プルリクエストを作成します

貢献のアイデア

• data.gov.co のデータセットを追加する
• README を翻訳する
• 新しい契約のアラートやモニタリング
• CSV/Excel へのエクスポート

ライセンス

MIT - 個人利用、商用利用、改変、再配布に自由にお使いいただけます。