oecd-mcp

v4.0.0

Published

24 days ago

OECD MCP - Model Context Protocol server for OECD statistical data via SDMX API

Downloads

247

0High
0Medium
0Low

isak.skogstad

mcp model-context-protocol oecd sdmx statistics economic-data claude

Svenska | English

OECD MCP Server

Model Context Protocol-server för OECD-statistik - Koppla LLM:er och AI-assistenter till 5 000+ ekonomiska dataset från OECD via SDMX API.

OECD (Organisationen för ekonomiskt samarbete och utveckling) är en mellanstatlig organisation med 38 medlemsländer som tillhandahåller omfattande ekonomisk och statistisk data.

🚀 Snabbstart

Fjärrserver (Rekommenderas)

Använd denna URL i vilken MCP-kompatibel klient som helst:

https://oecd-mcp-server.onrender.com/mcp

Ingen autentisering krävs! Klistra bara in URL:en - fungerar direkt med vilken MCP-klient som helst.

Kompatibel med: ChatGPT, Claude Web, VS Code Copilot, Cursor, och 400+ MCP-klienter.

Lokal Installation

# Kör direkt med npx (rekommenderas)
npx oecd-mcp

# Eller installera globalt
npm install -g oecd-mcp
oecd-mcp

Krav: Node.js >= 18.0.0

✨ Funktioner

9 MCP-verktyg - Sök, fråga och analysera OECD-data
5 000+ dataset - Över 17 kategorier (ekonomi, hälsa, utbildning, etc.)
Ingen autentisering - Offentlig API-åtkomst
Flera transporter - HTTP/JSON-RPC, SSE, och stdio
Automatisk övervakning - Dagliga tester säkerställer tillförlitlighet

📊 Populära Dataset

| Dataset | ID | Beskrivning | |---------|-----|-------------| | Kvartalsvis Nationalräkenskaper | QNA | BNP, konsumtion, investeringar per kvartal | | Huvudsakliga Ekonomiska Indikatorer | MEI | KPI, arbetslöshet, produktionsindex | | Ekonomisk Prognos | EO | Ekonomiska projektioner och prognoser | | Hälsostatistik | HEALTH_STAT | Sjukvårdssystem och resultat | | PISA-resultat | PISA | Utbildningsbedömningsresultat | | Grön Tillväxt | GREEN_GROWTH | Miljö- och ekonomiska indikatorer |

🔧 Verktyg

Dataset-upptäckt

search_dataflows - Sök dataset med nyckelord
list_dataflows - Bläddra dataset efter kategori
get_categories - Lista alla 17 datakategorier
get_popular_datasets - Hämta vanligt använda dataset
search_indicators - Sök specifika indikatorer

Dataåtkomst

get_data_structure - Hämta dataset-metadata
query_data - Fråga statistisk data
get_dataflow_url - Generera OECD Data Explorer URL
list_categories_detailed - Detaljerad kategoriinformation

📖 Exempel på Användning

// Sök efter BNP-dataset
await use_mcp_tool("oecd", "search_dataflows", {
  query: "GDP"
});

// Fråga USA BNP-data
await use_mcp_tool("oecd", "query_data", {
  dataflow_id: "QNA",
  filter: "USA.GDP..",
  start_period: "2020-Q1",
  end_period: "2023-Q4"
});

Anthropic-produkter

Claude Web (claude.ai)

Gå till Inställningar → Integrationer
Klicka på Lägg till anpassad connector
Ange: https://oecd-mcp-server.onrender.com/mcp

Claude Desktop

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

{
  "mcpServers": {
    "oecd": {
      "url": "https://oecd-mcp-server.onrender.com/mcp"
    }
  }
}

Eller lokal installation:

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

Claude Code (CLI)

# Fjärr
claude mcp add --transport http oecd https://oecd-mcp-server.onrender.com/mcp

# Lokal
claude mcp add oecd -- npx -y oecd-mcp

OpenAI-produkter

ChatGPT (Developer Mode)

Inställningar → Connectors → Advanced
Aktivera Developer Mode
Skapa connector med URL: https://oecd-mcp-server.onrender.com/mcp

VS Code med GitHub Copilot

Inställningar → Tillägg → MCP → Lägg till Server:

{
  "mcpServers": {
    "oecd": {
      "url": "https://oecd-mcp-server.onrender.com/mcp",
      "transport": "http"
    }
  }
}

Andra Klienter

Cursor AI

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

Lovable.dev / Firebase Studio

{
  "mcpServers": {
    "oecd": {
      "url": "https://oecd-mcp-server.onrender.com/sse",
      "transport": "sse"
    }
  }
}

| Kategori | Kod | Ämnen | Dataset | |----------|-----|-------|---------| | Ekonomi | ECO | BNP, inflation, prognoser | 500+ | | Sysselsättning | JOB | Arbetsmarknad, löner | 300+ | | Handel | TRD | Internationell handel | 250+ | | Hälsa | HEA | Sjukvård, livslängd | 200+ | | Utbildning | EDU | PISA, resultat | 180+ | | Miljö | ENV | Klimat, utsläpp | 150+ | | Innovation | STI | FoU, patent, AI | 140+ | | Energi | NRG | Produktion, förnybart | 120+ | | Beskattning | TAX | Skatteintäkter, satser | 100+ | | Finans | FIN | Marknader, bankväsen | 95+ | | Förvaltning | GOV | Offentlig sektor, styrning | 90+ | | Socialt | SOC | Ojämlikhet, livskvalitet | 85+ | | Jordbruk | AGR | Produktion, livsmedelstrygghet | 75+ | | Industri | IND | Industriproduktion | 70+ | | Utveckling | DEV | Utvecklingsbistånd | 60+ | | Transport | TRA | Infrastruktur, mobilitet | 50+ | | Regional | REG | Sub-nationell data | 45+ |

Projektstruktur

oecd-mcp/
├── src/
│   ├── index.ts              # MCP-server (stdio)
│   ├── http-server.ts        # HTTP-server
│   ├── http-jsonrpc-transport.ts
│   ├── oecd-client.ts
│   ├── sdmx-client.ts
│   └── types.ts
├── tests/contract/
├── Dockerfile
├── render.yaml
└── server.json

Kommandon

npm run build       # Kompilera TypeScript
npm start           # Starta HTTP-server
npm test            # Kör tester
npm run dev         # Bevakningsläge

Distribution

Render:

git push origin main
# Auto-distribuerar via render.yaml
# Hälsa: https://oecd-mcp-server.onrender.com/health

Docker:

docker build -t oecd-mcp .
docker run -p 3000:3000 oecd-mcp

API-endpoints

| Endpoint | Metod | Beskrivning | |----------|-------|-------------| | /mcp | GET/POST | MCP-protokoll | | /sse | GET | SSE-transport | | /health | GET | Hälsokontroll |

OECD API Returnerar Ingen Data

Verifiera dataflödes-ID med search_dataflows
Kontrollera filtersyntax matchar SDMX
Använd get_data_structure för att förstå dimensioner

Anslutningsproblem

Kontrollera OECD API-status: https://sdmx.oecd.org/public/rest/
Granska GitHub Actions för övervakning
Kontrollera serverloggar

Cold Starts (Render Gratis Plan)

Första förfrågan efter 15 min inaktivitet tar 30-60s
Efterföljande förfrågningar är snabba (~100-150ms)
Uppgradera till betald plan ($7/mån) för alltid-på

Bidrag är välkomna! Förbättringsområden:

Lägg till verifierade dataflöden till src/known-dataflows.ts
Exempel och handledningar
Förbättrade verktyg
Buggfixar och tester

Skicka en pull request

📜 Licens

MIT License - Se LICENSE

📚 Resurser

OECD Dataportalen: https://data.oecd.org/
SDMX-standard: https://sdmx.org/
MCP-dokumentation: https://modelcontextprotocol.io/
npm-paket: https://www.npmjs.com/package/oecd-mcp
Ärenden: GitHub Issues

Skapat av Isak Skogstad | Byggt med Model Context Protocol SDK