English Français العربية

io.github.HazloPosible/hacesfalta-mcp

السجل الرسمي البحث والويب

Search volunteer opportunities across Spain via hacesfalta.org

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «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
إعداد 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>"
            }
        }
    }
}

متغيرات البيئة

  • HACESFALTA_API_URL إلزامي Base URL of the HaceFalta API
  • HACESFALTA_API_KEY إلزامي سري API key for authenticating with the HaceFalta API

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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

الأسئلة الشائعة

ما هو io.github.HazloPosible/hacesfalta-mcp؟

Search volunteer opportunities across Spain via hacesfalta.org

كيف أثبّت io.github.HazloPosible/hacesfalta-mcp؟

يعمل على جهازك. في 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. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.HazloPosible/hacesfalta-mcp إلى مفتاح API؟

نعم. يتطلب HACESFALTA_API_URL, HACESFALTA_API_KEY، وتضبطها في إعداداته.

هل io.github.HazloPosible/hacesfalta-mcp مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.HazloPosible/hacesfalta-mcp؟

ينشره HazloPosible. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.