poliscope-mcp-server

poliscope-de/poliscope-mcp-server

3.3

If you are the rightful owner of poliscope-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Poliscope MCP Server is a tool designed to facilitate interaction with the Poliscope API, providing access to data on German administrative units, council meetings, and other relevant information directly within AI clients.

Tools

  1. get_entity

    Retrieve an administrative unit by its regional key (RS), optionally with subordinate units.

  2. list_entities

    List administrative units with filtering, sorting, and pagination options.

  3. count_entities

    Count administrative units that meet specific criteria.

  4. get_meetings

    Retrieve meetings with extensive filtering options (by administrative unit, topics, procedures, time period).

  5. count_meetings

    Count meetings that meet your filter criteria.

Poliscope MCP Server

⚠️⚠️⚠️⚠️

Dieses Projekt befindet sich noch in einer frßhen Entwicklungsphase und ist noch nicht fßr den produktiven Einsatz geeignet. Wir freuen uns ßber Beiträge zum Projekt oder kontaktiere uns unter

⚠️⚠️⚠️⚠️

Ein MCP (Model Context Protocol) Server, der Dir Tools zur Verfßgung stellt, um mit der Poliscope API zu arbeiten. Damit erhältst Du Zugriff auf Daten deutscher Verwaltungseinheiten, Gemeinderatssitzungen und weitere relevante Informationen, direkt in deinem AI-Client (Claude Desktop, Cursor,...).

Funktionsumfang

Der Server stellt Dir folgende Tools zur VerfĂźgung:

Verwaltungseinheiten

  • get_entity: Rufe eine Verwaltungseinheit Ăźber ihren RegionalschlĂźssel (RS) ab, optional mit untergeordneten Einheiten
  • list_entities: Liste Verwaltungseinheiten mit Filter-, Sortier- und Seitenfunktionen auf
  • count_entities: Zähle Verwaltungseinheiten, die bestimmte Kriterien erfĂźllen

Sitzungsdaten

  • get_meetings: Rufe Sitzungen mit umfangreichen FiltermĂśglichkeiten ab (nach Verwaltungseinheit, Themen, Verfahren, Zeitraum)
  • count_meetings: Zähle Sitzungen, die Deine Filterkriterien erfĂźllen

Installation fĂźr Claude Desktop

  1. Lade das Repository herunter oder klone es auf Deinen Computer.
  2. Erstelle einen API-SchlĂźssel in der Poliscope App und kopiere ihn.
  3. Fßge den Server zu Deiner MCP-Client-Konfiguration hinzu. In Claude Desktop trägst Du ihn in die claude_desktop_config.json ein:
{
  "mcpServers": {
    "poliscope": {
      "command": "node",
      "args": ["/pfad/zu/poliscope-mcp-server/build/index.js"],
      "env": {
        "POLISCOPE_API_KEY": "dein-api-schlĂźssel"
      }
    }
  }
}

Stelle sicher, dass Node.js auf Deinem Computer installiert ist.

  1. Starte Claude Desktop neu, damit die neue Server-Konfiguration geladen wird.
  2. Jetzt kannst Du die Poliscope MCP Server Tools in Claude Desktop verwenden.

Projektaufbau

poliscope-mcp-server/
├── src/
│   └── index.ts        # Haupt-Server Code
├── build/               # Kompilierte Dateien
├── package.json
├── tsconfig.json
└── README.md

API-Dokumentation

Die vollständige API-Dokumentation findest Du unter Poliscope API Docs.

Lizenz

MIT