Finstat MCP

finstat-mcp

MCP server, ktory sprístupňuje finstat.sk API ako nástroje pre Claude.

Umožňuje vyhľadávať slovenské firmy podľa názvu alebo IČO a získavať ich finančné údaje priamo v Claude Desktop.

Prerekvizity

• uv

Inštalácia

uv sync

Konfigurácia

1. Skopírujte .env.example do .env:

cp .env.example .env

1. Doplňte svoje API kľúče z finstat.sk:

FINSTAT_API_KEY=váš_api_kľúč
FINSTAT_PRIVATE_KEY=váš_privátny_kľúč

Použitie

Claude Desktop

Automatická inštalácia:

uv run mcp install src/finstat_mcp/server.py:mcp -f .env --name finstat

Alternatívne môžete manuálne upraviť konfiguračný súbor:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "finstat": {
      "command": "uv",
      "args": ["run", "--directory", "/ABSOLUTNA/CESTA/finstat_MCP", "finstat-mcp"],
      "env": {
        "FINSTAT_API_KEY": "váš_api_kľúč",
        "FINSTAT_PRIVATE_KEY": "váš_privátny_kľúč"
      }
    }
  }
}

Claude Code (CLI / VS Code extension)

claude mcp add --transport stdio --scope user \
  --env FINSTAT_API_KEY=váš_api_kľúč \
  --env FINSTAT_PRIVATE_KEY=váš_privátny_kľúč \
  finstat -- uv run --directory /ABSOLUTNA/CESTA/finstat_MCP finstat-mcp

Cursor

Pridajte konfiguráciu do jedného z týchto súborov:

• Globálny: ~/.cursor/mcp.json
• Projektový: .cursor/mcp.json

{
  "mcpServers": {
    "finstat": {
      "command": "uv",
      "args": ["run", "--directory", "/ABSOLUTNA/CESTA/finstat_MCP", "finstat-mcp"],
      "env": {
        "FINSTAT_API_KEY": "váš_api_kľúč",
        "FINSTAT_PRIVATE_KEY": "váš_privátny_kľúč"
      }
    }
  }
}

Windsurf

Upravte konfiguračný súbor ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "finstat": {
      "command": "uv",
      "args": ["run", "--directory", "/ABSOLUTNA/CESTA/finstat_MCP", "finstat-mcp"],
      "env": {
        "FINSTAT_API_KEY": "váš_api_kľúč",
        "FINSTAT_PRIVATE_KEY": "váš_privátny_kľúč"
      }
    }
  }
}

Iné klienty (VS Code, JetBrains, …)

Štandardný mcpServers JSON formát (rovnaký ako vyššie) funguje vo väčšine MCP-kompatibilných klientov. Konkrétne umiestnenie konfigurácie nájdete v dokumentácii daného klienta.

Vývoj

Spustenie MCP Inspector:

uv run mcp dev src/finstat_mcp/server.py:mcp

Nástroje

Základné informácie o firmách

Účtovné výkazy

Monitoring

Konkurzy a reštrukturalizácie

Exekúcie (spoplatnené)

Inteligentný reporting

API dokumentácia

Podrobnosti o FinStat API nájdete na finstat.sk.

Licencia

MIT