Qwerty Mcps

Herramientas para automatización personal. Nada de Python, nada de Node, nada de dependencias. Solo Rust compilado a un archivo binario que pesa ~7 MB.

---

🤔 ¿Qué es un MCP? (versión sin buzzwords)

Imaginá un programa que en vez de tener botones o página web, habla por texto. Le mandás una pregunta en JSON por el teclado, te responde con datos por la pantalla. Así de simple.

Pregunta: "¿qué clima hace en Tokyo?"
           ↓
  docker run -i --rm vega-weather-mcp
           ↓
Respuesta: {"temp": 28.3, "condition": "despejado"}

No tiene: puerto HTTP, página web, base de datos, login, cookies, sesiones. Sí tiene: un binary de 7 MB que hace UNA sola cosa y la hace bien.

---

📦 ¿Qué hay acá?

Carpeta	Qué hace	Cómo se usa
weather/	Clima actual + pronóstico 5 días	docker run -i --rm vega-weather-mcp
bitwarden/	Leer y guardar contraseñas en el vault	docker run -i --rm -v creds.json:/creds.json vega-bitwarden-mcp

---

🌤️ Weather MCP

Qué hace

Te dice el clima de cualquier ciudad del mundo. Gratis, sin API key, sin registro.

Herramienta

get_weather(lat?, lon?, mode?)

Parámetro	Default	Qué hace
lat	-31.42 (Córdoba)	Latitud
lon	-64.19 (Córdoba)	Longitud
mode	"current"	"current" = ahora, "forecast" = 5 días

Probar (sin instalar nada)

# Clima en Córdoba
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_weather","arguments":{}}}' \
  | docker run -i --rm vega-weather-mcp

# Clima en Tokyo
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_weather","arguments":{"lat":35.68,"lon":139.76}}}' \
  | docker run -i --rm vega-weather-mcp

# Pronóstico 5 días
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_weather","arguments":{"mode":"forecast"}}}' \
  | docker run -i --rm vega-weather-mcp

Lo que devuelve

{
  "city": "Córdoba",
  "temp": 13.5,
  "feels_like": 13.4,
  "temp_min": 13.3,
  "temp_max": 14.0,
  "humidity": 94.0,
  "pressure": 1021.0,
  "wind": 3.09,
  "condition": "Mist",
  "description": "niebla"
}

Cómo construirlo

cd weather
cargo build --release --target aarch64-unknown-linux-musl
cp target/aarch64-unknown-linux-musl/release/vega-weather-mcp .
docker build -t vega-weather-mcp .
# Listo. Imagen: 7 MB.

---

🔐 Bitwarden MCP

Qué hace

Lee y escribe en tu vault de Bitwarden/Vaultwarden. Guarda claves, busca contraseñas, crea items nuevos.

Requisito

El archivo de credenciales tiene que existir en la máquina host:

// /home/ubuntu/.bitwarden/credentials.json
{
  "bw_oauth": {
    "client_id": "user.xxxx",
    "client_secret": "yyyy",
    "server_url": "https://boveda.solisjavier.com.ar"
  }
}

Herramientas

Herramienta	Qué hace	Ejemplo
list_items	Lista items del vault	list_items(search="weather")
get_item	Trae un item completo	get_item(name="OpenWeatherMap API")
get_field	Saca un solo campo	get_field(item="OpenWeatherMap API", field="api_key")
create_login	Crea un login nuevo	create_login(name="Mi App", username="javi")
add_field	Agrega campo a un item	add_field(item="Mi App", name="token", value="abc123", type=1)

Probar

# Listar todo el vault
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_items","arguments":{}}}' \
  | docker run -i --rm -v $HOME/.bitwarden/credentials.json:/credentials.json:ro vega-bitwarden-mcp

# Buscar un item específico
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_item","arguments":{"name":"OpenWeatherMap"}}}' \
  | docker run -i --rm -v $HOME/.bitwarden/credentials.json:/credentials.json:ro vega-bitwarden-mcp

# Sacar solo la API key (sin JSON enorme)
echo '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_field","arguments":{"item_name":"OpenWeatherMap API","field_name":"api_key"}}}' \
  | docker run -i --rm -v $HOME/.bitwarden/credentials.json:/credentials.json:ro vega-bitwarden-mcp

Cómo construirlo

cd bitwarden
cargo build --release --target aarch64-unknown-linux-musl
cp target/aarch64-unknown-linux-musl/release/vega-bitwarden-mcp .
docker build -t vega-bitwarden-mcp .
# Listo. Imagen: 7.3 MB.

---

🔧 Stack técnico (para los que preguntan)

Capa	Qué usa
Lenguaje	Rust 2021 edition
SDK	rmcp 1.7 (stdio transport)
HTTP	reqwest + rustls (sin OpenSSL)
JSON	serde + serde_json
Container	Docker scratch (sin sistema operativo)
Binario	ELF estático compilado con musl
Peso	~7 MB por imagen

No usa: Python, Node.js, npm, pip, OpenSSL, glibc, dynamic linking.

---

🚀 Cómo agregar un MCP a Hermes

# ~/.hermes/config.yaml
mcp_servers:
  weather:
    command: docker
    args: [run, -i, --rm, vega-weather-mcp]
    transport: stdio

  bitwarden:
    command: docker
    args: [run, -i, --rm, -v, /home/ubuntu/.bitwarden/credentials.json:/credentials.json:ro, vega-bitwarden-mcp]
    transport: stdio

---

📋 Roadmap

• weather — clima OpenWeatherMap (gratis, español)
• bitwarden — vault autogestionado via API
• freshrss — noticias desde DB SQLite
• docmost — sync a wiki personal
• email — Microsoft Graph API

---

Proyecto personal de @ldgnu. Todo en Rust. Nada de Python.