suomi-mcp

English summary below ↓

Osa datakytkin-projektia. Kokoelma MCP-työkaluja, jotka tuovat suomalaista avointa dataa suoraan tekoälyavustajien käyttöön – ilman selaimessa kikkailua, PDF-latauksia tai leikepöytää.

Paikallisesti ajettava MCP-palvelin (stdio), joka tuo Claude Desktopin (tai muun MCP-yhteensopivan clientin) käyttöön 11 työkalua suomalaisiin avoimen datan rajapintoihin:

PRH: vanha avoindata.prh.fi/bis/v1 on poistettu käytöstä. Tämä palvelin käyttää nykyistä v3-rajapintaa (sama avoin YTJ-yrityshaku, ei API-avainta).

Hilma: käytetään Hilman julkista hakurajapintaa, joka ei vaadi avainta. Koko ilmoituksen eForms-XML:n saa erikseen AVP-read-rajapinnasta (ilmainen tilausavain) – sitä ei tässä tarvita.

Pikakäyttö

Vaatii Node.js 18+ polussa (kehitetty ja testattu Node 20:llä).

Lisää Claude Desktopin konfiguraatioon:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "datakytkin": {
      "command": "npx",
      "args": ["-y", "datakytkin-mcp"]
    }
  }
}

Käynnistä Claude Desktop uudelleen. Ei tarvita erillistä asennusta – npx hakee paketin npm:stä.

Jos näet virheen fetch is not defined

Claude Desktop käynnistää palvelimen omalla PATH:llaan, ja npx valitsee #!/usr/bin/env node -rivin kautta ensimmäisen node:n PATH:ssa – usein vanhan järjestelmä-Noden (esim. v16), josta puuttuu fetch. Vaihda tällöin suoraan absoluuttiseen Node 18+ -binääriin ja globaaliin asennukseen:

# asenna halutulla Nodella (esim. nvm:n Node 20)
"$(nvm which 20)" "$(dirname "$(nvm which 20)")/npm" install -g datakytkin-mcp
# tulosta polut configia varten:
echo "command: $(nvm which 20)"
echo "entry:   $("$(nvm which 20)" "$(dirname "$(nvm which 20)")/npm" root -g)/datakytkin-mcp/dist/index.js"

{
  "mcpServers": {
    "datakytkin": {
      "command": "/ABSOLUUTTINEN/POLKU/node/v20.x.x/bin/node",
      "args": ["/ABSOLUUTTINEN/POLKU/node/v20.x.x/lib/node_modules/datakytkin-mcp/dist/index.js"]
    }
  }
}

node ajetaan tässä eksplisiittisesti, joten PATH:n vanha Node ei häiritse. Päivitys: npm install -g datakytkin-mcp@latest samalla Nodella.

Related MCP server: finnish-company-mcp-server

Testikehotteet

1. "Hae PRH:sta yrityksen tiedot Y-tunnuksella 1629284-5."

2. "Etsi Hilmasta avoimet pilvipalveluihin liittyvät hankintailmoitukset, näytä 5."

3. "Hae YTJ:stä kaikki yritykset joiden nimessä on 'Reaktor' ja listaa Y-tunnukset."

4. "Näytä Hilmasta it-konsultoinnin tarjouspyynnöt ja niiden määräajat."

5. "Listaa Y-tunnuksen 1629284-5 viimeisimmät kaupparekisteriin rekisteröidyt muutokset."

6. "Onko yrityksellä 1234567-8 merkintöjä konkurssista tai saneerauksesta? Milloin hallitus on viimeksi muuttunut?"

7. "Mikä on pörssisähkön hinta nyt ja milloin tänään on halvinta?"

8. "Onko ALV-tunnus DE811128135 voimassa ja kenelle se kuuluu?"

9. "Millainen sää Rovaniemellä on seuraavat 12 tuntia?"

10. "Paljonko 500 markkaa vuonna 1990 on nykyrahassa?"

11. "Näytä kaikki tiedot Hilman tietoturvakonsultoinnin dynaamisesta hankintajärjestelmästä."

12. "Mitä maksaa neliö postinumerossa 33720?"

13. "Paljonko diesel maksaa nyt ja miten hinta on muuttunut vuodessa?"

14. "Onko IBAN FI21 1234 5600 0007 85 muodoltaan oikein ja minkä pankin tili?"

Kehitys

git clone https://github.com/datakytkin/suomi-mcp.git
cd suomi-mcp
nvm use 20        # tai: nvm install 20
npm install
npm run typecheck # tarkista että kääntyy
npm test          # vitest: työkalut (mockattu fetch), rekisteri, auth, mcp-server
npm run dev       # käynnistä palvelin stdio-tilassa (= npx tsx src/index.ts)

Palvelin puhuu MCP:tä stdin/stdout-yhteydellä; lokit menevät stderriin.

Käännetty ajo:

npm run build     # tuottaa dist/
npm start         # = node dist/index.js

Uuden työkalun lisääminen: ks. CONTRIBUTING.md. Käytännössä: luo src/tools/<lahde>.ts, vie siitä export const tool: ToolDefinition, valmista – src/tools/registry.ts löytää sen automaattisesti sekä stdio-palvelimeen että Gatewayhin.

Claude Desktop -konfiguraatio repo-checkoutista (kehitykseen / omiin muutoksiin):

{
  "mcpServers": {
    "datakytkin": {
      "command": "npx",
      "args": ["tsx", "/ABSOLUUTTINEN/POLKU/suomi-mcp/src/index.ts"]
    }
  }
}

Datasilta-Gateway (kokeellinen)

Sama työkalusetti tarjottuna keskitettynä HTTP-palvelimena, jotta asiakkaan ei tarvitse asentaa mitään paikallisesti – hän liittää yhden URL:n + tokenin suoraan Claude Desktopiin tai Grokin Custom Connectors -kenttään.

Gateway (src/gateway.ts, src/auth.ts) elää tässä samassa repossa (Open Core): koodi on MIT, kaupallinen arvo on hostatussa palvelussa + data-integraatioissa, ei transporttikoodissa. Jos/kun mukaan tulee laskutusta tai asiakastietoa, ne eriytetään omaksi (privaatiksi) osakseen.

npm install
DATASILTA_DEV_ALLOW_ANY=1 PORT=3000 npm run dev:gateway

Päätepisteet:

Mock-tokenit: demo (pro), 123 (free), enterprise. Kehityksessä DATASILTA_DEV_ALLOW_ANY=1 hyväksyy minkä tahansa ≥3 merkin tokenin.

Kovennukset: plan-kohtainen rate limit (free 20 / pro 120 / enterprise 600 kutsua/min, RateLimit-* + Retry-After -otsakkeet), rinnakkaisten SSE-sessioiden katto per asiakas, X-Request-Id + pyyntöloki, graceful shutdown (SIGTERM/SIGINT sulkee SSE-sessiot siististi – tärkeä konttiympäristöissä).

Julkinen testaus ngrokilla:

ngrok http 3000
# -> https://xxxx.ngrok-free.app/sse?token=demo  Grokiin / Claudeen

Kokeellinen. CORS on täysin auki ja auth on mock. Älä aja tätä julkisesti ilman oikeaa tokenvalidointia ja CORS-rajausta. ?token= URL:ssa vuotaa lokeihin – tuotannossa Authorization: Bearer.

Ei virallinen tuote

datakytkin on itsenäinen avoimen lähdekoodin projekti. Se käyttää PRH:n ja Hilman julkisia rajapintoja, mutta ei ole PRH:n, Hanselin, Hilman tai minkään viranomaisen hyväksymä, tukema tai ylläpitämä. Data tulee sellaisenaan lähteestä.

English

suomi-mcp is part of the datakytkin project: a set of Model Context Protocol tools that bring Finnish open government data straight into AI assistants – no browser tabs, PDF downloads or copy-paste.

A locally run MCP server (stdio) exposing 11 tools to Claude Desktop (or any MCP-compatible client):

Tool names and all output are in Finnish (that is the data's language).

Install

Requires Node.js 18+. Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "datakytkin": {
      "command": "npx",
      "args": ["-y", "datakytkin-mcp"]
    }
  }
}

Restart Claude Desktop.

Seeing fetch is not defined? Claude Desktop launches the server with its own PATH, and npx may pick an old system node (e.g. v16) that lacks fetch. Install globally with a Node 18+ binary and point command straight at it:

npm install -g datakytkin-mcp
npm root -g   # entry = <printed path>/datakytkin-mcp/dist/index.js

{
  "mcpServers": {
    "datakytkin": {
      "command": "/absolute/path/to/node18+/bin/node",
      "args": ["/absolute/path/to/lib/node_modules/datakytkin-mcp/dist/index.js"]
    }
  }
}

Not an official product

datakytkin is an independent open-source project. It consumes public APIs from PRH and Hilma but is not endorsed, supported or operated by PRH, Hansel, Hilma or any public authority. Data is served as-is from the source. See SECURITY.md for notes on the data sources and responsible use.

Lisenssi / License

MIT