coonet-mcp 0.1.0

MCP server for querying the CooNet Croatian news database — articles, entities, and trends

coonet-mcp

MCP server for querying the CooNet Croatian news database. Exposes 8 tools over the Model Context Protocol, allowing any MCP-compatible LLM to search articles, entities, and trends using natural language.

Install

pip install coonet-mcp

Setup

All you need is a PostgreSQL connection string to a CooNet database.

Claude Code

Place .mcp.json at your project root:

{
  "mcpServers": {
    "coonet": {
      "command": "coonet-mcp",
      "env": {
        "DATABASE_URL": "postgresql+asyncpg://coonet:coonet_dev@localhost:5432/coonet"
      }
    }
  }
}

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "coonet": {
      "command": "coonet-mcp",
      "env": {
        "DATABASE_URL": "postgresql+asyncpg://coonet:coonet_dev@localhost:5432/coonet"
      }
    }
  }
}

With uvx (no install needed)

{
  "mcpServers": {
    "coonet": {
      "command": "uvx",
      "args": ["coonet-mcp"],
      "env": {
        "DATABASE_URL": "postgresql+asyncpg://coonet:coonet_dev@localhost:5432/coonet"
      }
    }
  }
}

Available tools

Tool	Description
get_stats()	Database statistics: total articles, portals, entity count, date range
list_portals()	All news portals with IDs and status
list_categories()	All distinct article categories
search_articles(...)	Keyword search with portal, category, date filters
get_article(id)	Full article content by ID with optional NER entities
get_entity_mentions(...)	Most frequently mentioned entities (PER/ORG/LOC)
get_entity_co_occurrences(...)	Entities that co-occur with a given entity
get_articles_by_entity(...)	Articles mentioning a specific entity via NER tags

Requirements

• Python 3.11+
• A reachable PostgreSQL database with the CooNet schema