secop-mcp-server

SECOP MCP Server

用于通过 SECOP I 和 SECOP II 查询哥伦比亚公共采购信息的 MCP (Model Context Protocol) 服务。

数据从 datos.gov.co（Socrata 的 SODA API）实时获取，且 100% 公开。不会在本地存储任何数据。

有什么用途？

此服务允许 Claude 等大模型直接查询哥伦比亚政府的公共采购数据。这有助于：

• 政治监督： 调查公共机构和官员签订的合同。
• 透明度： 核实承包商、金额和采购方式。
• 数据新闻： 交叉比对供应商和机构的信息。
• 公民监督： 任何人都可以查询公共资源的使用情况。

可用数据集

数据集	描述	来源
SECOP I - 流程	公共采购流程的历史数据	datos.gov.co
SECOP II - 流程	交易型采购流程	datos.gov.co
SECOP II - 合同	包含已支付／已开票金额的电子合同	datos.gov.co
SECOP II - 供应商	在平台上注册的供应商	datos.gov.co

工具（Tools）

Tool	描述
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"]
    }
  }
}

App Token（可选但推荐）

不使用令牌也能运行，但会受到严格的速率限制（约 60 次请求／小时）。免费获取令牌：

1. 在 datos.gov.co 注册
2. 前往个人资料 > Developer Settings
3. 创建新的 App Token

将其配置为环境变量：

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

使用示例

配置完成后，你可以向 Claude 提出以下请求：

• “搜索波哥大市政府金额超过 10 亿的合同”
• “身份证号为 12345678 的人有哪些合同？”
• “显示安蒂奥基亚省的公开招标流程”
• “今年 SECOP II 金额最大的合同有哪些？”
• “搜索与 XYZ 公司相关的所有合同”
• “麦德林市在服务采购方面签订了多少合同？”
• “总结 EPM 在 2024 年的合同”
• “安蒂奥基亚省合同数量最多的供应商有哪些？”
• “按采购方式汇总麦德林市政府的合同”
• “显示 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. 向 datos.gov.co API 发起 HTTP 请求。
4. 将结果整理为易读文本并返回给 Claude。
5. Claude 分析数据并回复用户。

所有操作都在你的计算机上本地运行。没有中间服务，也不会存储数据。

贡献

欢迎贡献：

1. Fork 此仓库
2. 为你的功能创建分支（git checkout -b feature/nueva-funcionalidad）
3. 提交你的更改（git commit -m 'Agrega nueva funcionalidad'）
4. 将分支推送到远程（git push origin feature/nueva-funcionalidad）
5. 创建 Pull Request

贡献想法

• 添加更多 datos.gov.co 数据集
• 翻译 README
• 新合同提醒或监控
• 导出为 CSV/Excel

许可证

MIT - 可自由用于个人和商业用途，也可修改和再分发。