AI导哈

Notion AI代理

MCP Pilot是一个通过模型上下文协议（MCP）连接到Notion工作空间的AI代理，允许用户通过自然语言创建、读取、写入和更新Notion页面。

  • by rohit83r
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 rohit83r/MCPilot

使用说明

🤖 MCP Pilot——基于模型上下文协议（MCP）的人工智能概念代理

MCP飞行员 是一个基于人工智能的代理，可以连接到您的 Notion工作空间 通过 模型上下文协议（MCP） --允许您 创建、读取、写入和更新 Notion页面简单 说话 对于AI。

🧠 概述

MCP Pilot将您的Notion变成智能工作空间伴侣。

它使用：

  • 烧瓶 作为后端web服务器
  • 吸烟 公开安全的公共API
  • 双子座（或OpenAI） 作为LLM
  • Autogen+MCP 与Notion工具连接和交互

使用MCP Pilot，您可以运行以下命令：

“创建一个标题为 每周总结”
“总结一下我上周的笔记。”
“用新的里程碑更新Project X页面。”

代理与Notion通信 完全通过MCP，不需要手动API编码。

⚙️ 技术栈

组件 描述
后端 Flask（Python）
AI模型 双子座/OpenAI通过Autogen
MCP接口 MCP概念(https://mcp.notion.com/mcp)
网络 ngrok（用于公共HTTPS隧道）
前端 Lovable.dev（用户界面演示可选）
异步运行时 基于asyncio的代理任务

🚀 特性

✅ 通过MCP安全连接到Notion
✅ 使用自然语言创建、阅读和更新页面
✅ 使用ngrok在本地工作（无需云部署）
✅ 为集成提供REST API端点
✅ 基于异步Autogen Agent框架构建
✅ 易于扩展多个MCP工具

🧩 API终点

方法 端点 描述
GET /health 健康检查（验证服务器状态）
GET / 根端点
POST /run 在Notion上运行AI任务

示例请求

curl -X POST https://<your-ngrok-url>/run \
  -H "Content-Type: application/json" \
  -d '{"task": "Create a new Notion page titled MCP Pilot Overview"}'

示例响应

{
  "status": "success",
  "result": "Notion page 'MCP Pilot Overview' created successfully."
}

🧪 安装指南

1.️⃣ 克隆存储库

git clone https://github.com/rohit83r/MCPilot.git
cd MCPilot

2.️⃣ 创建虚拟环境

python -m venv venv
source venv/bin/activate   # on macOS/Linux
venv\Scripts\activate      # on Windows

3.️⃣ 再进行

pip install -r requirements.txt

4.️⃣ 创建一个 .env 文件

创建一个名为的文件 .env 在项目根目录中添加：

NOTION_SECRET=your_notion_integration_secret
GEMINI_API_KEY=your_gemini_or_openai_key
NGROK_AUTH_TOKEN=your_ngrok_auth_token

💡 您可以创建一个Notion集成，并从以下位置获取您的秘密： https://www.notion.so/my-integrations

5.️⃣ 运行Flask服务器

python final.py

您将看到如下输出：

Public URL: https://xxxx.ngrok.io/health

 * Running on http://127.0.0.1:7001

访问浏览器中的公共URL进行验证！

🧠 建筑

            ┌──────────────────────────┐
            │        Frontend UI       │
            │    (Lovable / Postman)   │
            └────────────┬─────────────┘
                         │
                         ▼
              ┌─────────────────┐
              │  Flask Web API  │
              │ (/run, /health) │
              └────────┬────────┘
                       │
                       ▼
              ┌───────────────────────────────┐
              │   Autogen AI Agent (Gemini)   │
              │  └──> MCP Tools for Notion    │
              └───────────────────────────────┘
                       │
                       ▼
              ┌────────────────────────────┐
              │   Notion MCP Endpoint      │
              │   https://mcp.notion.com   │
              └────────────────────────────┘

💬 示例用例

  • 直接在Notion中创建项目文档
  • 根据会议摘要自动更新任务列表
  • 总结并整理你的笔记
  • 构建自定义AI驱动的Notion工作流

📜 许可证

该项目根据 MIT许可证

💡 贡献

欢迎拉取请求！ 如果你想贡献：

  1. 分叉回购
  2. 创建要素分支
  3. 承诺并推动
  4. 打开PR

🌟 支持

如果你喜欢这个项目，请⭐ 将存储库星化 并在LinkedIn或Twitter上分享！

建造于 罗希特·斯里瓦斯 --探索Agent AI、MCP和智能自动化的未来🚀

相关 MCP