convez.ai
MCP ServerDados & AnalyticsIntermediário
malkreide

Swiss Culture MCP

malkreide/swiss-culture-mcp

Acesso a dados de patrimônio cultural suíço para assistentes de IA

Ver no GitHub
BomPluginScore · de 0 a 100

Servidor MCP que integra dados de patrimônio cultural suíço (BAK) — inventário ISOS de paisagens urbanas protegidas, tradições vivas de patrimônio imaterial e prêmios culturais. Sem necessidade de chave de API, utiliza dados públicos abertos suíços.

Instalação

$npx convez-ai malkreide/swiss-culture-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
71%
Último commit
há 6 dias
Versão
v1.2.0
Issues abertas
0
Contribuidores
2

Casos de uso

  • Pesquisa de paisagens urbanas protegidas (ISOS) por cantão ou tipo de assentamento
  • Consultas sobre tradições culturais vivas e patrimônio imaterial suíço
  • Busca de informações sobre prêmios culturais suíços (cinema, literatura, música)
  • Acesso a comunicados de imprensa e notícias do Escritório Federal de Cultura

Veredito

MCP bem estruturado para integração de dados culturais públicos suíços. Útil para aplicações de pesquisa, turismo cultural e análise de patrimônio, mas público bastante nicho — relevante principalmente para contextos suíços ou pesquisa comparativa de política cultural.

README

A tradução para o português deste README ainda está na fila.

🇨🇭 Part of the Swiss Public Data MCP Portfolio

🏛️ swiss-culture-mcp

Version License: MIT Python 3.11+ MCP Data Source CI

MCP server for Swiss cultural heritage data from the Federal Office of Culture (BAK) — ISOS townscapes, Living Traditions, cultural prizes, press releases. No API key required.

🌐 English | Deutsch


Overview

swiss-culture-mcp makes Swiss cultural data accessible to AI assistants. The server connects LLMs like Claude with Switzerland's national cultural heritage: from protected townscapes (ISOS) to living traditions of intangible cultural heritage and current cultural awards.

Sources: geo.admin.ch REST API · news.admin.ch RSS · opendata.swiss CKAN · lebendige-traditionen.ch

No API key required. All data sources are publicly available (Open Government Data).

Anchor demo query: "Which protected townscapes are there in the school districts of the city of Zurich, and what living traditions are practised there?"


Features

  • 🏘️ ISOS search – Federal Inventory of Swiss Townscapes Worth Protecting by name, canton or settlement type
  • 📜 Living Traditions – 228 entries of Swiss intangible cultural heritage
  • 🏆 Cultural prizes – Swiss Film Prize, Grand Prix Literature, Music Prize and more
  • 📰 BAK press releases – current news from the Federal Office of Culture
  • 📦 Open data catalogue – BAK datasets on opendata.swiss
  • ☁️ Dual transport – stdio for Claude Desktop, Streamable HTTP for cloud deployment
#ToolDescription
1bak_search_isosSearch ISOS townscapes by place name
2bak_isos_by_kantonList all ISOS objects in a canton
3bak_get_isos_detailGet full details of an ISOS object
4bak_isos_by_kategorieFilter ISOS by settlement type (Stadt, Dorf, etc.)
5bak_isos_statisticsISOS inventory statistics (sampled by canton)
6bak_get_newsCurrent BAK press releases
7bak_get_kulturpreiseSwiss cultural prizes (Film Prize, Grand Prix Literature, etc.)
8bak_get_opendataBAK datasets on opendata.swiss
9bak_list_traditionsList Switzerland's Living Traditions
10bak_get_tradition_detailGet detailed description of a tradition

3 Resources: bak://isos/kantone · bak://isos/kategorien · bak://kulturpreise/uebersicht


Data Sources

SourceAPI TypeContent
geo.admin.chREST MapServerISOS (Federal Inventory of Swiss Townscapes)
news.admin.chRSS FeedBAK press releases, cultural prizes
opendata.swissCKAN REST APIBAK open data datasets
lebendige-traditionen.chHTML Fetch228 entries of intangible cultural heritage

Prerequisites

  • Python 3.11+
  • uv or pip
  • No API keys required

Installation

# Recommended: uvx (no install step needed)
uvx swiss-culture-mcp

# Alternative: pip
pip install swiss-culture-mcp

Quickstart

# Start the server (stdio mode for Claude Desktop)
uvx swiss-culture-mcp

Try it immediately in Claude Desktop:

"Show me all protected townscapes in the canton of Graubünden" "Which living traditions are practised in canton Appenzell?" "Which Swiss cultural prizes were awarded in 2026?"


Configuration

Environment Variables

VariableDefaultDescription
MCP_TRANSPORTstdioTransport: stdio or streamable_http
MCP_HOST127.0.0.1Bind host for HTTP transport (loopback by default)
MCP_PORT8000Port for HTTP transport
MCP_ALLOW_PUBLIC_BINDfalseIf true, permits binding 0.0.0.0 without auth. Set this only behind an authenticating reverse proxy (e.g. Cloudflare Access, oauth2-proxy).
LOG_LEVELINFODEBUG, INFO, WARNING, ERROR — structured JSON logs to stderr

Claude Desktop Configuration

{
  "mcpServers": {
    "swiss-culture": {
      "command": "uvx",
      "args": ["swiss-culture-mcp"]
    }
  }
}

Config file locations:

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

After restarting Claude Desktop, all tools are available. Example queries:

  • "Show me all protected townscapes in the canton of Graubünden"
  • "What is the Alphorn and Büchelspiel tradition?"
  • "Which Swiss cultural prizes were awarded in 2026?"
  • "Is the old town of Stein am Rhein in the ISOS inventory?"
  • "Which living traditions are practised in canton Appenzell?"

Cloud Deployment (Streamable HTTP)

For use via claude.ai in the browser (e.g. on managed workstations without local software):

Render.com (recommended):

  1. Push/fork the repository to GitHub
  2. On render.com: New Web Service → connect GitHub repo
  3. Set environment variables in the Render dashboard
  4. In claude.ai under Settings → MCP Servers, add: https://your-app.onrender.com/mcp
# Docker / local HTTP mode (loopback only — safe default)
MCP_TRANSPORT=streamable_http MCP_PORT=8000 python -m swiss_culture_mcp.server

# Public bind (DANGEROUS — only behind an authenticating reverse proxy)
MCP_TRANSPORT=streamable_http MCP_HOST=0.0.0.0 MCP_ALLOW_PUBLIC_BIND=true \
    python -m swiss_culture_mcp.server

⚠️ Security: The server itself has no authentication. Binding to a public interface without an upstream auth layer turns it into an open proxy for the federal data sources. Always run an authenticating reverse proxy (Cloudflare Access, oauth2-proxy, nginx + auth_request) in front of 0.0.0.0 deployments.


Architecture

┌─────────────────┐     ┌──────────────────────────┐     ┌──────────────────────────┐
│   Claude / AI   │────▶│   Swiss Culture MCP      │────▶│  geo.admin.ch REST       │
│   (MCP Host)    │◀────│   (MCP Server)           │◀────│  news.admin.ch RSS       │
└─────────────────┘     │                          │     │  opendata.swiss CKAN     │
                        │  10 Tools · 3 Resources  │     │  lebendige-traditionen   │
                        │  Stdio | Streamable HTTP  │     └──────────────────────────┘
                        └──────────────────────────┘

Project Structure

swiss-culture-mcp/
├── src/
│   └── swiss_culture_mcp/
│       ├── __init__.py
│       └── server.py          # All 10 tools, 3 resources
├── tests/
│   ├── conftest.py            # pytest configuration
│   └── test_server.py         # 36 tests (unit + live)
├── pyproject.toml
├── CHANGELOG.md
├── CONTRIBUTING.md            # Contribution guide (English)
├── CONTRIBUTING.de.md         # Contribution guide (German)
├── SECURITY.md               # Security policy & posture (English)
├── SECURITY.de.md            # Security policy & posture (German)
├── LICENSE
├── README.md                  # This file (English)
└── README.de.md               # German version

Testing

# Unit tests (no API key required)
PYTHONPATH=src pytest tests/ -m "not live"

# Integration tests (live API calls)
PYTHONPATH=src pytest tests/ -m "live"

Example Use Cases

Schools / Education

"Which protected townscapes are there in the school districts of the city of Zurich?"
→ bak_isos_by_kanton(kanton="ZH") + bak_get_isos_detail(...)

"Find living traditions for a project week on the theme of cultural heritage"
→ bak_list_traditions() + bak_get_tradition_detail(slug="...")

"Which UNESCO World Heritage Sites are also in ISOS?"
→ bak_search_isos(query="...") + bak_get_opendata(query="UNESCO")

City Administration / Spatial Planning

"Is the building at address X within an ISOS perimeter?"
→ bak_search_isos(query="community/place name")

"Which BAK datasets are available for GIS integration?"
→ bak_get_opendata() → WMS/WFS URLs for GIS software

AI Working Group / Demos

"Show current cultural policy of the federal government"
→ bak_get_news() + bak_get_kulturpreise()
→ More use cases by audience →

Safety & Limits

AspectDetails
AccessRead-only — the server cannot modify or delete any data
Personal dataNo personal data — all sources are aggregated, public cultural heritage data
Rate limitsBuilt-in per-query caps (e.g. max 100 ISOS results, 50 news items, 200 category entries)
Timeout20 seconds per API call
AuthenticationNo API keys required — all 4 data sources are publicly accessible
LicensesAll data under open licenses (Open Government Data): geo.admin.ch, opendata.swiss, news.admin.ch
Terms of ServiceSubject to ToS of the respective data sources: geo.admin.ch, opendata.swiss, news.admin.ch, lebendige-traditionen.ch

Known Limitations

  • ISOS statistics: Sample-based per canton (not exhaustive for all cantons)
  • Living Traditions: HTML scraping – may break if lebendige-traditionen.ch changes its structure
  • BAK news/prizes: RSS feed limited to the most recent entries
  • opendata.swiss CKAN: Full-text search may return results from other publishers

Synergies with Other MCP Servers

swiss-culture-mcp can be combined with other servers in the portfolio:

CombinationUse Case
+ swiss-transport-mcpCultural tourism: day trips to traditions by public transport
+ zurich-opendata-mcpLocal cultural atlas: ISOS + Zurich city events
+ global-education-mcpCultural education in international comparison
+ fedlex-mcpCultural property transfer act + BAK enforcement practice
+ swiss-statistics-mcpCultural expenditure by canton (BFS data)

Changelog

See CHANGELOG.md


Security

Security posture, hardening details and the responsible-disclosure process are documented in SECURITY.md.


Contributing

Contributions are welcome — see CONTRIBUTING.md.


License

MIT License — see LICENSE


Author

Hayal Oezkan · malkreide


Credits & Related Projects

Installation

Run via uv's uvx — no clone or manual install needed. Add to your MCP client config (mcpServers for Claude Desktop, Cursor and Windsurf; use a top-level servers key for VS Code in .vscode/mcp.json):

{
  "mcpServers": {
    "swiss-culture-mcp": {
      "command": "uvx",
      "args": [
        "swiss-culture-mcp"
      ]
    }
  }
}
Ver o original no GitHub

Bom para

Relacionados