English Français العربية

io.github.HazloPosible/hacesfalta-mcp

Registre officiel Recherche et web

Search volunteer opportunities across Spain via hacesfalta.org

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

NPM package @hacesfalta/mcp-server
Claude Code 
claude mcp add hacesfalta-mcp -e 'HACESFALTA_API_URL=<HACESFALTA_API_URL>' -e 'HACESFALTA_API_KEY=<your hacesfalta_api_key>' -- npx -y @hacesfalta/mcp-server@1.0.1
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "hacesfalta-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@hacesfalta/mcp-server@1.0.1"
            ],
            "env": {
                "HACESFALTA_API_URL": "<HACESFALTA_API_URL>",
                "HACESFALTA_API_KEY": "<your hacesfalta_api_key>"
            }
        }
    }
}

Variables d'environnement

  • HACESFALTA_API_URL obligatoire Base URL of the HaceFalta API
  • HACESFALTA_API_KEY obligatoire secret API key for authenticating with the HaceFalta API

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. HaceFalta MCP Server
  2. Herramientas disponibles
  3. Conexión remota (Claude, ChatGPT, Gemini)
  4. Conexión local (Claude Desktop)
  5. Ejemplo de uso
  6. Sobre hacesfalta.org
  7. Licencia

HaceFalta MCP Server

Servidor MCP (Model Context Protocol) que expone el catálogo de oportunidades de voluntariado de hacesfalta.org — la principal plataforma de voluntariado en España — para que agentes de IA puedan ayudar a las personas a encontrar oportunidades de voluntariado mediante conversación natural.

Herramientas disponibles

HerramientaDescripción
buscar_oportunidadesBusca oportunidades por provincia, categoría, frecuencia, horario, edad, fin de semana, en familia o en grupo. Devuelve resultados paginados con enlaces de inscripción.
detalle_oportunidadObtiene el detalle completo de una oportunidad: descripción, perfil buscado, fechas, horarios, competencias, ODS y enlace de inscripción.
listar_categoriasLista todas las categorías de voluntariado disponibles con el número de oportunidades en cada una.
listar_provinciasLista todas las provincias españolas con oportunidades de voluntariado.

Conexión remota (Claude, ChatGPT, Gemini)

URL del servidor MCP:

https://hacesfalta-mcp.hacesfalta.workers.dev/mcp
Claude (web y móvil)
  1. Ve a Settings → Connectors → Add MCP Server
  2. Introduce la URL: https://hacesfalta-mcp.hacesfalta.workers.dev/mcp
ChatGPT
  1. Ve a Settings → Developer Mode → Add MCP Server
  2. Introduce la URL: https://hacesfalta-mcp.hacesfalta.workers.dev/mcp

Conexión local (Claude Desktop)

Añade a tu claude_desktop_config.json:

{
  "mcpServers": {
    "hacesfalta": {
      "command": "node",
      "args": ["path/to/hacesfalta-mcp/dist/index.js"],
      "env": {
        "HACESFALTA_API_URL": "https://api.hacesfalta.org",
        "HACESFALTA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Ejemplo de uso

Un usuario le dice a su agente de IA:

"Quiero hacer voluntariado con personas mayores en Madrid los fines de semana"

El agente usa buscar_oportunidades con los filtros provincia: "Madrid", categoria: "Mayores", fin_de_semana: true y devuelve oportunidades relevantes con enlaces directos a hacesfalta.org para inscribirse.

Sobre hacesfalta.org

hacesfalta.org es la plataforma de referencia de voluntariado en España, gestionada por la Fundación HazloPosible. Conecta a personas con ganas de ayudar con organizaciones que necesitan voluntarios.

Licencia

MIT

Questions fréquentes

Qu'est-ce que io.github.HazloPosible/hacesfalta-mcp ?

Search volunteer opportunities across Spain via hacesfalta.org

Comment installer io.github.HazloPosible/hacesfalta-mcp ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add hacesfalta-mcp -e 'HACESFALTA_API_URL=<HACESFALTA_API_URL>' -e 'HACESFALTA_API_KEY=<your hacesfalta_api_key>' -- npx -y @hacesfalta/mcp-server@1.0.1. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.HazloPosible/hacesfalta-mcp ?

Oui. Il attend HACESFALTA_API_URL, HACESFALTA_API_KEY, à renseigner dans sa configuration.

io.github.HazloPosible/hacesfalta-mcp est-il open source ?

Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.

Qui maintient io.github.HazloPosible/hacesfalta-mcp ?

Il est publié par HazloPosible. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.