hacesfalta-mcp

Name: hacesfalta-mcp
Author: HazloPosible

远程服务

github.com/HazloPosible搜索与检索014 周前更新

代码仓库

关于 hacesfalta-mcp

hacesfalta-mcp 让 AI Agent 搜索 hacesfalta.org 上的西班牙志愿服务机会。它支持筛选、分页结果、机会详情和直接报名链接。

主要功能

01按省份和类别搜索
02按时间及参与者条件筛选
03分页返回机会结果
04获取完整机会详情
05列出类别和省份

适用场景

01寻找马德里的周末志愿服务
02查找适合家庭或团体的机会
03查看岗位详情后前往报名

MCP 相关

该 MCP 服务提供搜索、机会详情、类别列表和省份列表工具。可通过 MCP URL 远程连接，也可在 Claude Desktop 中本地配置。

#voluntariado #volunteering #spain #nonprofit #social-impact #hacesfalta

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "hacesfalta": {
      "command": "npx",
      "args": [
        "-y",
        "@hacesfalta/mcp-server"
      ],
      "env": {
        "HACESFALTA_API_URL": "<HACESFALTA_API_URL>",
        "HACESFALTA_API_KEY": "<HACESFALTA_API_KEY>"
      }
    }
  }
}

启动命令npx -y @hacesfalta/mcp-server

需要配置的环境变量

HACESFALTA_API_URLBase URL of the HaceFalta API

HACESFALTA_API_KEY密钥API key for authenticating with the HaceFalta API

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@hacesfalta/mcp-server1.0.1stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

HaceFalta MCP 服务

MCP（Model Context Protocol）服务，开放 hacesfalta.org 的志愿服务机会目录——西班牙领先的志愿服务平台——让 AI Agent 能通过自然对话帮助人们寻找志愿服务机会。

可用工具

工具	描述
`buscar_oportunidades`	按省份、类别、频率、时间安排、年龄、周末、家庭或团体搜索机会。返回带报名链接的分页结果。
`detalle_oportunidad`	获取机会的完整详情：描述、目标人群、日期、时间安排、能力要求、可持续发展目标（ODS）和报名链接。
`listar_categorias`	列出所有可选的志愿服务类别及每个类别的机会数量。
`listar_provincias`	列出所有有志愿服务机会的西班牙省份。

远程连接（Claude、ChatGPT、Gemini）

MCP 服务 URL：

https://hacesfalta-mcp.hacesfalta.workers.dev/mcp

Claude（网页和移动端）

前往 Settings → Connectors → Add MCP Server
输入 URL：https://hacesfalta-mcp.hacesfalta.workers.dev/mcp

ChatGPT

前往 Settings → Developer Mode → Add MCP Server
输入 URL：https://hacesfalta-mcp.hacesfalta.workers.dev/mcp

本地连接（Claude Desktop）

将以下内容添加到你的 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"
      }
    }
  }
}

使用示例

用户对其 AI Agent 说：

“我想在马德里周末和老年人一起做志愿服务。”

Agent 使用 buscar_oportunidades，并应用筛选条件 provincia: "Madrid"、categoria: "Mayores"、fin_de_semana: true，然后返回相关机会及指向 hacesfalta.org 的直接报名链接。

关于 hacesfalta.org

hacesfalta.org 是西班牙知名的志愿服务平台，由 Fundación HazloPosible 管理。该平台将热心助人的人们与需要志愿者的组织联系起来。

许可证

MIT

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。