Cause Connect MCP Server

原因连接MCP服务器

一个模型上下文协议（MCP）服务器，促进捐赠者与非政府组织与Every.org非营利组织数据访问的集成交互。此服务器提供用于非营利组织发现、捐赠管理、合规性跟踪、赞助商匹配和分析的工具。

特性

• 非营利数据集成：实时访问Every.org的100多万非营利组织数据库
• 基于角色的访问控制：捐助者、非政府组织、合规官员、赞助商和管理员的不同权限
• 捐赠管理：认捐创建和跟踪系统
• 合规性监测：非政府组织核查和文件跟踪
• 赞助商匹配：非营利组织与适当赞助商的自动匹配
• 支付模拟：模拟支付处理，计算赞助商费用
• 分析仪表板：行业分析和资金见解

建筑

服务器使用混合架构：

• 主服务器 （FastAPI）：处理MCP协议和核心业务逻辑
• Every.org子进程：用于非营利数据API调用的专用MCP服务器
• 沟通：进程之间通过stdin/stdout的JSON-RPC

可用工具

核心工具

1. ngo_info -重定向到适当Every.org工具的传统工具
2. 保证 -创建和管理捐赠承诺
3. 合规 -查看非政府组织合规状态和文件
4. 赞助商匹配 -将非政府组织与符合条件的赞助商配对
5. 支付 -通过费用计算模拟付款处理
6. 非政府组织分析 -获取行业分析和资金见解

Every.org集成工具

1. search_nonprofits -按名称或关键字搜索非营利组织
2. 获取_无利润_详细信息 -获取特定非营利组织的详细信息
3. 浏览_无利润_因 -按事业类别（教育、健康、环境等）浏览非营利组织

快速开始

先决条件

• Python 3.11+
• Docker（推荐）
• Every.org API密钥

Docker安装程序（推荐）

1. 构建容器：

   docker build -t donor-ngo-mcp-server .

1. 使用环境变量运行：

   docker run -p 8003:8003 \
     -e EVERY_ORG_API_KEY=your_api_key_here \
     -e AUTH_MODE=AUTO \
     donor-ngo-mcp-server

地方发展

1. 安装依赖项：

   pip install -r requirements.txt

1. 设置环境变量：

   export EVERY_ORG_API_KEY=your_api_key_here
   export AUTH_MODE=AUTO

1. 运行服务器：

   python main.py --host 127.0.0.1 --port 8003

身份验证和授权

身份验证模式

• 自动 （默认）：自动为测试分配管理员角色
• 严格：需要有效的授权令牌

令牌格式

• 捐助者: donor_123
• 非政府组织: ngo_org123_user456
• 合规: compliance_123
• 赞助商: sponsor_123
• 管理员: admin_123

访问控制

不同的代理类型可以访问不同的工具：

API示例

搜索教育非营利组织

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "browse_nonprofits_by_cause",
    "arguments": {
      "cause": "education",
      "limit": 5
    }
  },
  "id": 1
}

创建捐赠承诺

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "pledge",
    "arguments": {
      "action": "create",
      "ngo_id": "some-nonprofit-id",
      "amount": 1000.0,
      "message": "Supporting education initiatives"
    }
  },
  "id": 2
}

获取非营利组织详细信息

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "name": "get_nonprofit_details",
    "arguments": {
      "nonprofit_id": "givedirectly"
    }
  },
  "id": 3
}

健康终点

• GET/健康 -总体服务器运行状况
• GET/ping -简单连接测试
• GET/everyorg/状态 -Every.org集成状态
• GET/测试每个组织 -测试Every.org API连接

环境变量

支持的非营利事业

Every.org集成支持以下原因类别：

• education -教育机构和项目
• health -医疗保健和医学研究
• environment -环境保护
• poverty -扶贫和社会服务
• animals -动物福利和保护
• arts -艺术、文化和人文
• community -社区发展
• disaster-relief -应急响应和救灾
• human-services -社会和人类服务
• international -国际发展
• research -科学和学术研究
• religion -宗教组织

错误处理

服务器为常见场景提供详细的错误响应：

• 403禁止：请求的工具权限不足
• 404未找到：未找到资源（认捐、非政府组织等）
• 503服务不可用：Every.org集成不可用
• 400错误请求：参数无效或请求格式错误

发展

项目结构

├── main.py                 # Main server implementation
├── requirements.txt        # Python dependencies
├── Dockerfile             # Container configuration
├── everyorg_mcp_server.py # Auto-generated Every.org subprocess
└── README.md             # This file

添加新工具

1. 在工具处理程序部分创建处理程序函数
2. 将工具定义添加到 tools/list 响应
3. 在中添加路由逻辑 tools/call 处理器
4. 更新中的访问控制规则 AuthService.check_tool_access()

调试

服务器包括全面的日志记录。为了调试Every.org集成问题：

1. 检查 /everyorg/status 子流程状态的端点
2. 使用 /test-everyorg 测试API连接
3. 使用启用调试日志记录 --log-level debug

许可证

本项目按原样提供，用于演示目的。

支持

关于以下问题：

• Every.org API：联系Every.org支持
• MCP协议：请参阅模型上下文协议文档
• 服务器问题：检查运行状况端点和日志