Jグランツ-Fördersuche MCP — torchi PoC

Ein schreibgeschützter Remote-MCP zur Nutzung der Jグランツ Public API von デジタル庁 über MCP-Clients wie Notion.

Basierend auf dem öffentlichen Beispiel digital-go-jp/jgrants-mcp-server von デジタル庁 wurden Authentifizierung, Health Checks, Container-Konfiguration und Ausgabemengensteuerung für den Dauerbetrieb mit Sliplane hinzugefügt.

Bereitgestellte Tools

• ping — Verbindungsprüfung

• search_subsidies — Suche nach Schlüsselwörtern, Region, Branche, Mitarbeiterzahl und Verwendungszweck

• get_subsidy_overview — Zusammenfassung nach Fristzeitraum und Höchstbetrag

• get_subsidy_detail — Details und Liste der Anhänge abrufen

• get_file_content — Nur ausgewählte Anhänge in Markdown umwandeln

Die Suchergebnisse enthalten die offizielle JグランツURL und die Quellenangabe. Die abgerufenen Informationen dienen nur als Referenz; bitte prüfen Sie vor der Antragstellung die aktuellsten Informationen auf der offiziellen Seite.

Related MCP server: koko-call-mcp

Remote-Konfiguration

Notion
  -> HTTPS + Bearer token
  -> Caddy gateway（公開）
  -> FastMCP server（Sliplane内部のみ）
  -> Jグランツ公開API

• /health wird für Überwachungszwecke ohne Authentifizierung öffentlich bereitgestellt.

• /mcp validiert dasselbe Bearer token sowohl im Gateway als auch im MCP-Hauptmodul.

• Das Token wird ausschließlich in den Secret-Umgebungsvariablen von Sliplane gespeichert und nicht in GitHub oder Logs aufgenommen.

• Anhänge werden im temporären Bereich des MCP-Hauptmoduls gespeichert; nur die benötigten Dateien werden als Inhalt zurückgegeben.

Lokale Entwicklung

Es werden Python 3.10 oder höher und uv verwendet.

uv sync
uv run pytest
JGRANTS_REQUIRE_AUTH=0 uv run python -m jgrants_mcp_server

Die Docker-Konfiguration mit Authentifizierung ist wie folgt.

cp .env.example .env
# .envのMCP_AUTH_TOKENを32文字以上のランダム値へ変更
docker compose up --build
curl http://localhost:8080/health
curl -i http://localhost:8080/mcp

Ein nicht authentifizierter Zugriff auf /mcp führt zu HTTP 401.

Sliplane-Konfiguration

Aus demselben GitHub-Repository werden zwei Dienste erstellt.

jgrants-mcp

• Dockerfile: Dockerfile

• Öffentlich: Aus

• Healthcheck: /health

• Umgebungsvariablen:

  • JGRANTS_HOST=0.0.0.0

  • JGRANTS_PATH=/mcp

  • JGRANTS_REQUIRE_AUTH=1

  • MCP_AUTH_TOKEN=<secret>

  • PORT=8000

jgrants-mcp-gateway

• Dockerfile: gateway/Dockerfile

• Öffentlich: Ein

• Healthcheck: /health

• Umgebungsvariablen:

  • MCP_AUTH_TOKEN=<same secret>

  • UPSTREAM_URL=http://jgrants-mcp.internal:8000

Pushes auf main werden für die automatische Bereitstellung vorgesehen. In Notion registrieren Sie die URL, die aus der öffentlichen URL des Gateways und /mcp besteht, sowie das Bearer token.

Lizenz und Quellenangabe

Der Code steht unter der MIT License. Für die Nutzung der JグランツAPI gelten die JグランツAPI-Nutzungsbedingungen. Bei Veröffentlichung oder Weiterverwendung ist Jグランツ als Quelle anzugeben.