mcp-swiss 0.5.1-dev → 0.5.2-dev-beta.20260308192446

package/README.md

@@ -13,6 +13,8 @@
 [![Downloads](https://img.shields.io/npm/dm/mcp-swiss.svg?style=flat-square)](https://www.npmjs.com/package/mcp-swiss)
 [![Stars](https://img.shields.io/github/stars/vikramgorla/mcp-swiss?style=flat-square)](https://github.com/vikramgorla/mcp-swiss)
 [![Node](https://img.shields.io/node/v/mcp-swiss?style=flat-square)](https://nodejs.org)
+[![.mcpb](https://img.shields.io/badge/.mcpb-One--Click_Install-D52B1E?style=flat-square)](https://github.com/vikramgorla/mcp-swiss/releases/latest/download/mcp-swiss.mcpb)
+[![Claude Desktop](https://img.shields.io/badge/Claude_Desktop-Install-D52B1E?style=flat-square&logo=anthropic&logoColor=white)](https://github.com/vikramgorla/mcp-swiss/releases/latest/download/mcp-swiss.mcpb)
 
 [Install](#installation) · [Tools](#tools) · [Demo](#demo-prompts) · [Data Sources](#data-sources)
 
@@ -62,6 +64,18 @@ That's it. No API keys, no `.env` files, no accounts. Pick your client below and
 
 ---
 
+### One-Click Install (.mcpb)
+
+`.mcpb` bundles work with Claude Desktop and any MCP Bundle-compatible app.
+
+[**⬇ Download mcp-swiss.mcpb**](https://github.com/vikramgorla/mcp-swiss/releases/latest/download/mcp-swiss.mcpb)
+
+[![Install in Claude Desktop](https://img.shields.io/badge/Install_in_Claude_Desktop-D52B1E?style=for-the-badge&logo=anthropic&logoColor=white)](https://github.com/vikramgorla/mcp-swiss/releases/latest/download/mcp-swiss.mcpb)
+
+Open the downloaded file — your app handles the rest. No config editing, no terminal, no API keys.
+
+---
+
 ### Claude Desktop
 
 Edit your config file:

package/manifest.json

@@ -0,0 +1,112 @@
+{
+  "manifest_version": "0.3",
+  "name": "mcp-swiss",
+  "display_name": "Switzerland MCP 🇨🇭",
+  "version": "0.5.1",
+  "description": "Swiss open data for AI — 68 tools, zero API keys. Transport, weather, geodata, companies, parliament, and 15 more modules.",
+  "long_description": "mcp-swiss gives any AI assistant direct access to Swiss open data. 68 tools across 20 modules: train schedules (SBB), weather (MeteoSwiss), river levels (BAFU), geodata (swisstopo), company registry (ZEFIX), parliament, avalanche bulletins, holidays, postal services, electricity prices, population statistics, exchange rates (SNB), recycling schedules, news (SRF), voting results, dam registry, hiking trail alerts, real estate data, traffic counts, and earthquake monitoring. All APIs are free and require zero authentication.",
+  "author": {
+    "name": "Vikram Gorla",
+    "url": "https://github.com/vikramgorla"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/vikramgorla/mcp-swiss.git"
+  },
+  "homepage": "https://github.com/vikramgorla/mcp-swiss",
+  "documentation": "https://github.com/vikramgorla/mcp-swiss/blob/main/docs/tool-specs.md",
+  "support": "https://github.com/vikramgorla/mcp-swiss/issues",
+  "icon": "assets/icon.png",
+  "server": {
+    "type": "node",
+    "entry_point": "dist/index.js",
+    "mcp_config": {
+      "command": "node",
+      "args": ["${__dirname}/dist/index.js"]
+    }
+  },
+  "tools": [
+    {"name": "search_stations", "description": "Search for Swiss public transport stations/stops by name or coordinates"},
+    {"name": "get_connections", "description": "Get train/bus connections between two Swiss locations"},
+    {"name": "get_departures", "description": "Get live departures from a Swiss transport station"},
+    {"name": "get_arrivals", "description": "Get live arrivals at a Swiss transport station"},
+    {"name": "get_nearby_stations", "description": "Find Swiss public transport stations near given coordinates"},
+    {"name": "get_weather", "description": "Get current weather conditions at a Swiss MeteoSwiss station"},
+    {"name": "list_weather_stations", "description": "List all available MeteoSwiss weather stations in Switzerland"},
+    {"name": "get_weather_history", "description": "Get historical weather data for a Swiss station"},
+    {"name": "get_water_level", "description": "Get current river or lake water level and temperature at a Swiss hydrological station"},
+    {"name": "list_hydro_stations", "description": "List all available BAFU hydrological monitoring stations"},
+    {"name": "get_water_history", "description": "Get historical river/lake water level data for a Swiss hydrological station"},
+    {"name": "geocode", "description": "Convert a Swiss address or place name to coordinates (swisstopo)"},
+    {"name": "reverse_geocode", "description": "Convert coordinates to a Swiss address (swisstopo)"},
+    {"name": "search_places", "description": "Search Swiss place names, localities, mountains, and geographic features"},
+    {"name": "get_solar_potential", "description": "Get rooftop solar energy potential for a location in Switzerland"},
+    {"name": "identify_location", "description": "Identify geographic features and data layers at a specific Swiss location"},
+    {"name": "get_municipality", "description": "Get information about a Swiss municipality by name"},
+    {"name": "search_companies", "description": "Search Swiss company registry (ZEFIX) by name, canton, or legal form"},
+    {"name": "get_company", "description": "Get full details of a Swiss company by its ZEFIX internal ID"},
+    {"name": "search_companies_by_address", "description": "Search Swiss companies registered at a specific address or locality"},
+    {"name": "list_cantons", "description": "List all Swiss cantons with their codes"},
+    {"name": "list_legal_forms", "description": "List all Swiss company legal forms (AG, GmbH, etc.)"},
+    {"name": "get_public_holidays", "description": "Get public holidays for a Swiss canton and year"},
+    {"name": "get_school_holidays", "description": "Get school holidays for a Swiss canton"},
+    {"name": "is_holiday_today", "description": "Check if today is a public holiday in a Swiss canton"},
+    {"name": "get_latest_votes", "description": "Get the latest parliament votes"},
+    {"name": "search_councillors", "description": "Search current National/States Council members"},
+    {"name": "get_sessions", "description": "Get parliament session schedule"},
+    {"name": "search_parliament_business", "description": "Search parliamentary affairs and bills"},
+    {"name": "get_avalanche_bulletin", "description": "Get SLF avalanche danger bulletin"},
+    {"name": "list_avalanche_regions", "description": "List avalanche warning regions"},
+    {"name": "get_air_quality", "description": "Get NABEL air quality measurements"},
+    {"name": "list_air_quality_stations", "description": "List NABEL air quality monitoring stations"},
+    {"name": "lookup_postcode", "description": "Look up a Swiss postcode"},
+    {"name": "search_postcode", "description": "Search Swiss postcodes by locality name"},
+    {"name": "list_postcodes_in_canton", "description": "List all postcodes in a Swiss canton"},
+    {"name": "track_parcel", "description": "Track a Swiss Post parcel"},
+    {"name": "get_electricity_tariff", "description": "Get electricity tariff for a Swiss municipality"},
+    {"name": "compare_electricity_tariffs", "description": "Compare electricity prices across municipalities"},
+    {"name": "search_municipality_energy", "description": "Search municipalities for energy data"},
+    {"name": "get_population", "description": "Get population data by canton or municipality"},
+    {"name": "search_statistics", "description": "Search BFS statistical datasets"},
+    {"name": "get_statistic", "description": "Get a specific BFS statistic"},
+    {"name": "get_exchange_rate", "description": "Get current CHF exchange rate from SNB"},
+    {"name": "get_exchange_rate_history", "description": "Get historical exchange rates"},
+    {"name": "list_currencies", "description": "List available currency pairs"},
+    {"name": "get_waste_collection", "description": "Get waste collection schedule"},
+    {"name": "list_waste_types", "description": "List available waste types"},
+    {"name": "get_waste_calendar", "description": "Get waste collection calendar"},
+    {"name": "get_swiss_news", "description": "Get SRF news headlines"},
+    {"name": "search_swiss_news", "description": "Search Swiss news by keyword"},
+    {"name": "get_voting_results", "description": "Get popular vote results"},
+    {"name": "get_vote_details", "description": "Get detailed vote breakdown"},
+    {"name": "search_votes", "description": "Search available vote dates and topics"},
+    {"name": "search_dams", "description": "Search Swiss federal dam registry"},
+    {"name": "get_dams_by_canton", "description": "Get dams by canton"},
+    {"name": "get_dam_details", "description": "Get details of a specific dam"},
+    {"name": "get_trail_closures", "description": "Get hiking trail closures and alerts"},
+    {"name": "get_trail_closures_nearby", "description": "Get trail closures near coordinates"},
+    {"name": "get_property_price_index", "description": "Get Swiss property price index"},
+    {"name": "get_rent_index", "description": "Get rental price index"},
+    {"name": "search_real_estate_data", "description": "Search real estate market data"},
+    {"name": "get_traffic_count", "description": "Get traffic count data from ASTRA stations"},
+    {"name": "get_traffic_by_canton", "description": "Get traffic data by canton"},
+    {"name": "get_traffic_nearby", "description": "Get traffic data near coordinates"},
+    {"name": "get_recent_earthquakes", "description": "Get recent earthquakes in Switzerland"},
+    {"name": "get_earthquake_details", "description": "Get details of a specific earthquake"},
+    {"name": "search_earthquakes_by_location", "description": "Search earthquakes near a location"}
+  ],
+  "keywords": [
+    "switzerland", "swiss", "open-data", "transport", "sbb", "weather",
+    "meteoswiss", "geodata", "swisstopo", "zefix", "companies", "parliament",
+    "avalanche", "holidays", "postal", "energy", "statistics", "exchange-rates",
+    "recycling", "news", "voting", "dams", "hiking", "real-estate", "traffic",
+    "earthquakes"
+  ],
+  "license": "MIT",
+  "compatibility": {
+    "platforms": ["darwin", "win32", "linux"],
+    "runtimes": {
+      "node": ">=20.0.0"
+    }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-swiss",
-  "version": "0.5.1-dev",
+  "version": "0.5.2-dev-beta.20260308192446",
   "description": "Swiss open data MCP server — 68 tools across 20 modules. Zero API keys.",
   "main": "dist/index.js",
   "bin": {

package/scripts/build-mcpb.sh

@@ -0,0 +1,37 @@
+#!/bin/bash
+# Build .mcpb (MCP Bundle) for Claude Desktop
+set -euo pipefail
+
+VERSION=$(node -p "require('./package.json').version")
+BUNDLE_NAME="mcp-swiss-${VERSION}.mcpb"
+BUNDLE_DIR="$(mktemp -d)"
+
+echo "Building mcpb bundle v${VERSION}..."
+
+# Build the project first
+npm run build
+
+# Copy required files to bundle directory
+cp -r dist/ "${BUNDLE_DIR}/dist/"
+cp -r node_modules/ "${BUNDLE_DIR}/node_modules/"
+cp package.json "${BUNDLE_DIR}/"
+cp manifest.json "${BUNDLE_DIR}/"
+
+# Copy icon if it exists
+if [ -d "assets" ]; then
+  cp -r assets/ "${BUNDLE_DIR}/assets/"
+fi
+
+# Create the .mcpb (zip) file
+cd "${BUNDLE_DIR}"
+zip -r "/tmp/${BUNDLE_NAME}" . -x "*.git*" "*.DS_Store"
+cd -
+
+# Move to project root
+mv "/tmp/${BUNDLE_NAME}" "./${BUNDLE_NAME}"
+
+# Cleanup
+rm -rf "${BUNDLE_DIR}"
+
+echo "✅ Created ${BUNDLE_NAME} ($(du -h "${BUNDLE_NAME}" | cut -f1))"
+echo "   Install: Open with Claude Desktop"

package/scripts/qa-per-tool.sh

@@ -0,0 +1,156 @@
+#!/bin/bash
+# QA Smoke Test — one prompt per tool (68 tools across 20 modules)
+# Runs locally via Claude Code MCP client
+
+set -o pipefail
+
+export CLAUDE_CODE_OAUTH_TOKEN=$(grep CLAUDE_CODE_OAUTH_TOKEN ~/.bashrc | cut -d'"' -f2)
+MCP='{"mcpServers":{"swiss":{"command":"node","args":["dist/index.js"]}}}'
+OPTS="--permission-mode bypassPermissions --max-turns 5 --mcp-config $MCP"
+PASS=0
+FAIL=0
+FAILED_TESTS=()
+
+run_test() {
+  local tool="$1"
+  local prompt="$2"
+  echo ""
+  echo "=== [$tool] ==="
+  if OUTPUT=$(claude -p "$prompt" $OPTS 2>&1); then
+    echo "$OUTPUT" | tail -5
+    echo "✅ $tool"
+    PASS=$((PASS + 1))
+  else
+    echo "$OUTPUT" | tail -5
+    echo "❌ $tool FAILED"
+    FAIL=$((FAIL + 1))
+    FAILED_TESTS+=("$tool")
+  fi
+}
+
+# Build first
+npm run build || { echo "BUILD FAILED"; exit 1; }
+
+echo "=========================================="
+echo "QA Per-Tool Smoke Tests — 68 tools"
+echo "=========================================="
+
+# --- Transport (5) ---
+run_test "search_stations" "Search for train stations named Interlaken. Use the search_stations swiss MCP tool."
+run_test "get_connections" "Get the next train connection from Bern to Zürich. Use the get_connections swiss MCP tool."
+run_test "get_departures" "Show departures from Zürich HB station. Use the get_departures swiss MCP tool."
+run_test "get_arrivals" "Show arrivals at Basel SBB. Use the get_arrivals swiss MCP tool."
+run_test "get_nearby_stations" "Find train stations near latitude 46.95, longitude 7.44. Use the get_nearby_stations swiss MCP tool."
+
+# --- Weather (6) ---
+run_test "get_weather" "Current weather in Bern. Use the get_weather swiss MCP tool."
+run_test "list_weather_stations" "List all MeteoSwiss weather stations. Use the list_weather_stations swiss MCP tool."
+run_test "get_weather_history" "Weather history for Bern in the last 24 hours. Use the get_weather_history swiss MCP tool."
+run_test "get_water_level" "Current water level of the Aare river. Use the get_water_level swiss MCP tool."
+run_test "list_hydro_stations" "List all hydrology stations. Use the list_hydro_stations swiss MCP tool."
+run_test "get_water_history" "Water level history for the Aare. Use the get_water_history swiss MCP tool."
+
+# --- Geodata (6) ---
+run_test "geocode" "Geocode the address Bundesplatz 3 Bern. Use the geocode swiss MCP tool."
+run_test "reverse_geocode" "Reverse geocode latitude 46.9481 longitude 7.4474. Use the reverse_geocode swiss MCP tool."
+run_test "search_places" "Search for places named Zermatt. Use the search_places swiss MCP tool."
+run_test "get_solar_potential" "Solar potential at latitude 46.95 longitude 7.45. Use the get_solar_potential swiss MCP tool."
+run_test "identify_location" "Identify what is at latitude 46.95 longitude 7.45. Use the identify_location swiss MCP tool."
+run_test "get_municipality" "Get municipality info for Bern. Use the get_municipality swiss MCP tool."
+
+# --- Companies (5) ---
+run_test "search_companies" "Search for Nestlé in ZEFIX. Use the search_companies swiss MCP tool."
+run_test "get_company" "Get details for company with UID CHE-105.909.036. Use the get_company swiss MCP tool."
+run_test "search_companies_by_address" "Search companies at address Vevey. Use the search_companies_by_address swiss MCP tool."
+run_test "list_cantons" "List all Swiss cantons. Use the list_cantons swiss MCP tool."
+run_test "list_legal_forms" "List Swiss company legal forms. Use the list_legal_forms swiss MCP tool."
+
+# --- Holidays (3) ---
+run_test "get_public_holidays" "Public holidays in Zürich 2026. Use the get_public_holidays swiss MCP tool."
+run_test "get_school_holidays" "School holidays in Zürich 2026. Use the get_school_holidays swiss MCP tool."
+run_test "is_holiday_today" "Is today a public holiday in Switzerland? Use the is_holiday_today swiss MCP tool."
+
+# --- Parliament (4) ---
+run_test "search_parliament_business" "Search parliamentary business about climate. Use the search_parliament_business swiss MCP tool."
+run_test "get_latest_votes" "Latest 3 parliamentary votes. Use the get_latest_votes swiss MCP tool."
+run_test "search_councillors" "Search for councillor named Baume-Schneider. Use the search_councillors swiss MCP tool."
+run_test "get_sessions" "List recent parliamentary sessions. Use the get_sessions swiss MCP tool."
+
+# --- Avalanche (2) ---
+run_test "get_avalanche_bulletin" "Current avalanche bulletin info. Use the get_avalanche_bulletin swiss MCP tool."
+run_test "list_avalanche_regions" "List all avalanche warning regions. Use the list_avalanche_regions swiss MCP tool."
+
+# --- Air Quality (2) ---
+run_test "list_air_quality_stations" "List all NABEL air quality stations. Use the list_air_quality_stations swiss MCP tool."
+run_test "get_air_quality" "Air quality legal limits in Switzerland. Use the get_air_quality swiss MCP tool."
+
+# --- Post (4) ---
+run_test "lookup_postcode" "What is the postcode for Zermatt? Use the lookup_postcode swiss MCP tool."
+run_test "search_postcode" "Search for postcodes starting with 80. Use the search_postcode swiss MCP tool."
+run_test "list_postcodes_in_canton" "List postcodes in canton Zug. Use the list_postcodes_in_canton swiss MCP tool."
+run_test "track_parcel" "Track parcel 990012345678. Use the track_parcel swiss MCP tool."
+
+# --- Energy (3) ---
+run_test "get_electricity_tariff" "Electricity tariff in Bern for 2026. Use the get_electricity_tariff swiss MCP tool."
+run_test "compare_electricity_tariffs" "Compare electricity tariffs between Zürich and Lugano. Use the compare_electricity_tariffs swiss MCP tool."
+run_test "search_municipality_energy" "Search for energy municipality Bern. Use the search_municipality_energy swiss MCP tool."
+
+# --- Statistics (3) ---
+run_test "get_population" "Population of canton Zürich. Use the get_population swiss MCP tool."
+run_test "search_statistics" "Search for statistics about housing. Use the search_statistics swiss MCP tool."
+run_test "get_statistic" "Get a statistic about population. Use the get_statistic swiss MCP tool."
+
+# --- SNB (3) ---
+run_test "list_currencies" "List all SNB tracked currencies. Use the list_currencies swiss MCP tool."
+run_test "get_exchange_rate" "Current CHF to EUR exchange rate. Use the get_exchange_rate swiss MCP tool."
+run_test "get_exchange_rate_history" "EUR/CHF exchange rate history for the last year. Use the get_exchange_rate_history swiss MCP tool."
+
+# --- Traffic (3) ---
+run_test "get_traffic_count" "Traffic count at Gotthard. Use the get_traffic_count swiss MCP tool."
+run_test "get_traffic_by_canton" "Traffic stations in canton Zürich. Use the get_traffic_by_canton swiss MCP tool."
+run_test "get_traffic_nearby" "Traffic stations near latitude 47.37 longitude 8.54. Use the get_traffic_nearby swiss MCP tool."
+
+# --- Recycling (3) ---
+run_test "get_waste_collection" "Next waste collection for ZIP 8001. Use the get_waste_collection swiss MCP tool."
+run_test "list_waste_types" "List all waste collection types. Use the list_waste_types swiss MCP tool."
+run_test "get_waste_calendar" "Waste calendar for ZIP 8005 in March 2026. Use the get_waste_calendar swiss MCP tool."
+
+# --- News (2) ---
+run_test "get_swiss_news" "Latest Swiss news headlines. Use the get_swiss_news swiss MCP tool."
+run_test "search_swiss_news" "Search Swiss news for climate. Use the search_swiss_news swiss MCP tool."
+
+# --- Voting (3) ---
+run_test "get_voting_results" "Recent Swiss popular vote results. Use the get_voting_results swiss MCP tool."
+run_test "search_votes" "Search votes about AHV. Use the search_votes swiss MCP tool."
+run_test "get_vote_details" "Details of the E-ID vote. Use the get_vote_details swiss MCP tool."
+
+# --- Dams (3) ---
+run_test "search_dams" "Search for Grande Dixence dam. Use the search_dams swiss MCP tool."
+run_test "get_dams_by_canton" "List dams in canton Valais. Use the get_dams_by_canton swiss MCP tool."
+run_test "get_dam_details" "Full details of Grande Dixence dam. Use the get_dam_details swiss MCP tool."
+
+# --- Hiking (2) ---
+run_test "get_trail_closures" "Current hiking trail closures in Switzerland. Use the get_trail_closures swiss MCP tool."
+run_test "get_trail_closures_nearby" "Trail closures near Interlaken latitude 46.69 longitude 7.85. Use the get_trail_closures_nearby swiss MCP tool."
+
+# --- Real Estate (3) ---
+run_test "get_property_price_index" "Swiss property price index trend. Use the get_property_price_index swiss MCP tool."
+run_test "search_real_estate_data" "Search for real estate datasets on opendata.swiss. Use the search_real_estate_data swiss MCP tool."
+run_test "get_rent_index" "Swiss rent price index. Use the get_rent_index swiss MCP tool."
+
+# --- Earthquakes (3) ---
+run_test "get_recent_earthquakes" "Recent earthquakes in Switzerland. Use the get_recent_earthquakes swiss MCP tool."
+run_test "get_earthquake_details" "Get details of the most recent Swiss earthquake. Use the get_recent_earthquakes tool first, then get_earthquake_details for the first event."
+run_test "search_earthquakes_by_location" "Earthquakes near Bern latitude 46.95 longitude 7.45 in the last 90 days. Use the search_earthquakes_by_location swiss MCP tool."
+
+# --- Summary ---
+echo ""
+echo "=========================================="
+echo "RESULTS: $PASS passed, $FAIL failed out of $((PASS + FAIL))"
+echo "=========================================="
+if [ $FAIL -gt 0 ]; then
+  echo "FAILED TOOLS:"
+  for t in "${FAILED_TESTS[@]}"; do echo "  ❌ $t"; done
+  exit 1
+fi
+echo "✅ ALL 68 TOOLS PASSED"

package/server.json

@@ -1,13 +1,13 @@
 {
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.vikramgorla/swiss",
-  "title": "Switzerland MCP 🇨🇭",
+  "title": "Switzerland MCP \ud83c\udde8\ud83c\udded",
   "description": "Swiss open data MCP server. 68 tools, zero API keys. Transport, weather, geodata, news, rates.",
   "repository": {
     "url": "https://github.com/vikramgorla/mcp-swiss",
     "source": "github"
   },
-  "version": "0.5.1-dev",
+  "version": "0.5.2-dev",
   "icons": [
     {
       "src": "https://raw.githubusercontent.com/vikramgorla/mcp-swiss/main/assets/icon.svg",
@@ -25,7 +25,7 @@
     {
       "registryType": "npm",
       "identifier": "mcp-swiss",
-      "version": "0.5.1-dev",
+      "version": "0.5.2-dev",
       "runtimeHint": "npx",
       "transport": {
         "type": "stdio"