资助规划智能系统

MAI Advisor是一个AI驱动的资助规划系统,通过战略框架和自主AI代理执行,帮助非营利组织在90天内将资助申请从每年2-3份提升至10-15份。

  • by nbiish
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 nbiish/mai-advisor-mcp

使用说明

🎯 MAI顾问-多智能体情报拨款计划系统

MCP 1岁生日黑客马拉松参赛作品 |企业跟踪(两类)

一个完整的人工智能资助计划系统,通过战略框架和自主的人工智能代理执行,在90天内将非营利组织从每年2-3个资助申请转变为10-15个申请。


🌟 这个系统做什么

MAI顾问提供 双重部署模式 为了进行全面的拨款规划:

🖥️ Gradio Web界面

  • 用户友好的用户界面 用于立即生成拨款策略
  • 6项综合产出 60秒后:
    • 搜索引擎傻瓜(谷歌、必应、DuckDuckGo)
    • 财务管理框架
    • 赠款写作策略
    • 研究方法论
    • 精心策划的拨款计划
    • AI代理执行指令(8000+字)
  • 公共访问 -用户提供自己的OpenRouter API密钥
  • 零设置 -在浏览器中运行

🔌 MCP服务器集成

  • 本地MCP协议 克劳德桌面
  • 4工具 通过模型上下文协议公开
  • 3知识资源 用于战略指导
  • 异步stdio传输 用于生产用途

🚀 快速开始

选项1:拥抱面部空间(无需安装)

访问已部署的空间(即将推出):

https://huggingface.co/spaces/nbiish/mai-advisor-grant-planning
  1. 输入您的OpenRouter API密钥(免费获得一个)
  2. 输入资助主题和地点
  3. 制定完整的战略
  4. 下载6个综合文件

方案2:地方发展

# Clone repository
git clone https://github.com/nbiish/mai-advisor-mcp.git
cd mai-advisor-mcp/mai-advisor-mcp

# Setup virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Run Gradio app
python app_workflow.py

访问http://localhost:7860

选项3:MCP服务器(克劳德桌面)

# Run setup script
python docs/setup/setup_claude_config.py

# Restart Claude Desktop
# Use: "Generate a grant strategy for community health in Seattle"

看 安装文档 详细说明。


📦 存储库结构

mai-advisor-mcp/
├── mai-advisor-mcp/              # Main application directory
│   ├── app_workflow.py           # Gradio web interface (production)
│   ├── src/                      # Core source code
│   │   ├── advisor_tools.py      # Strategic framework generators
│   │   ├── dork_generator.py     # Search query optimization
│   │   ├── grant_agent.py        # AI research agent (OpenRouter)
│   │   ├── search_operators.py   # Advanced search strategies
│   │   ├── server.py             # Full MCP server
│   │   └── server_simplified.py  # Minimal MCP server
│   ├── docs/                     # Organized documentation
│   │   ├── setup/                # Installation guides
│   │   ├── deployment/           # HuggingFace deployment
│   │   ├── hackathon/            # Submission materials
│   │   └── development/          # Development docs
│   ├── examples/                 # Usage examples
│   ├── huggingface_space_deploy/ # Production deployment package
│   ├── requirements.txt          # Python dependencies
│   └── LICENSE                   # MIT License
├── .github/                      # GitHub configuration
├── .venv/                        # Virtual environment (local)
└── README.md                     # This file

🎯 主要特点

非营利组织

  • 速度提高99.9% 初稿生成(30-60秒vs几周)
  • 增长400% 在资助申请中(每年10-15次vs 2-3次)
  • 自动发现 -AI代理发现机会
  • 战略框架 -不仅仅是文本生成
  • 经过验证的流程 -专注于小型非营利组织

技术创新

  • 双重部署 -Web UI+MCP服务器
  • OpenRouter集成 -免费谷歌Gemini 2.0 Flash
  • MCP协议 -原生Claude桌面支持
  • 自治代理 -8000+字执行计划
  • 公共访问 -无需身份验证
  • 用户提供的API密钥 -零成本风险

企业级质量

  • 生产准备就绪 带有错误处理功能的代码
  • 全面的文件 -设置、部署、使用
  • 干净的建筑 -模块化、可测试、可维护
  • 安全 -没有硬编码的秘密,用户提供的密钥
  • 演出 -异步操作,优化工作流程

📚 文档

设置和安装

部署

黑客马拉松提交

发展


🏗️ 建筑

系统流量

User Input (Topic + Location)
    ↓
Orchestrator Layer
    ↓
┌────────────────────┬──────────────────┬───────────────────┐
│                    │                  │                   │
Search Dork       Financial         Grant            Research
Generator         Advisor           Expert           Expert
    │                │                  │                   │
    └────────────────┴──────────────────┴───────────────────┘
                              ↓
                     Orchestrator Synthesis
                              ↓
                     AI Agent TODO Generator
                              ↓
                    6 Comprehensive Outputs

MCP集成

Claude Desktop
    ↓
MCP Protocol (stdio)
    ↓
MAI Advisor Server
    ↓
┌──────────┬──────────┬──────────┬──────────┐
│  Tool 1  │  Tool 2  │  Tool 3  │  Tool 4  │
│ generate │  dorks   │ get_todo │ get_plan │
│ strategy │   only   │          │          │
└──────────┴──────────┴──────────┴──────────┘

🔑 API密钥

OpenRouter(必需)

获取免费的API密钥: openrouter.ai/keys

  • 型号: 谷歌双子座2.0 Flash
  • 成本: 免费等级可用
  • 用途: 战略框架生成

Tavily(可选)

为了增强研究能力:

  • 注册地址: tavily.com
  • 增添 .env 本地开发文件

🤝 贡献

这是一个黑客马拉松提交项目。比赛结束后:

  1. 复刻仓库
  2. 创建特征分支(git checkout -b feature/amazing-feature)
  3. 提交更改(git commit -m 'Add amazing feature')
  4. 推送到分支(git push origin feature/amazing-feature)
  5. 打开拉取请求

📄 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。


🏆 黑客马拉松赛道

MCP 1岁生日黑客马拉松 -两个企业轨道:

  1. 建设MCP(企业) -本地MCP服务器实现

    • 4个生产就绪工具
    • 3知识资源
    • 异步stdio传输
    • Claude桌面集成
  2. MCP在行动(企业) -自主AI代理工作流程

    • 8000+字执行计划
    • 90天赠款获取时间表
    • 支持浏览器的AI集成
    • 人在环审批

🙏 致谢

  • Anthropic -模型上下文协议规范
  • OpenRouter -免费使用谷歌Gemini 2.0 Flash
  • 格拉迪奥 -优秀的web UI框架
  • 抱抱脸 -空间托管平台
  • LangChain -AI编排工具

📞 联系

开发商: nbiish
存储库: github/nbiish/mai-advisor-mcp
拥抱脸: 拥抱脸.co/nbish


⭐ 如果你觉得这个仓库有用,就把它标上!

内置于❤️ 为寻求最大限度地提高拨款潜力的非营利组织提供资金。