AI导哈

Notion自动化代理

一个基于MCP协议和Google ADK的AI代理，用于自动化Notion工作流程、数据分析和内容更新。

  • by maskedwolf4
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 maskedwolf4/notion-mcp-adk-agent

使用说明

MCP ADK代理概念

本项目是关于使用MCP服务器和Google ADK构建一个Notion代理

基于Google ADK&MCP架构的概念代理

项目概述

该项目是一个AI驱动的代理，使用MCP协议连接到Notion，利用Google ADK进行编排。 该代理可以读取、分析和更新Notion数据库或页面，从而轻松自动化工作流程、提取见解或为Notion工作区构建智能助手。

建筑

  • 谷歌ADK：提供代理框架、处理模型编排、工具集成和部署。
  • MCP（模型上下文协议）：充当代理和Notion之间的桥梁，将Notion的API操作（如读取、创建和更新页面）公开为代理可以使用的工具。
  • MCP服务器概念：正式的Notion集成，包装Notion API端点，并通过MCP向您的代理公开它们。

层：

  • 模型上下文层（大脑）： LLM（例如Gemini、GPT-4）处理请求并做出决策。
  • 协议层（神经系统）： MCP客户端连接到Notion MCP服务器，处理身份验证和工具发现。
  • 运行时层（肌肉）： 根据LLM的决定对Notion执行操作。

安装说明

  1. 克隆存储库

    git clone https://github.com/maskedwolf4/Notion-MCP-ADK-Agent
cd Notion-MCP-ADK-Agent

  2. 安装依赖项

    pip install -r requirements.txt

  3. 创建概念集成

    • 首选 概念开发者 并创建新的集成。
    • 保存生成的Notion API令牌。

  4. 配置环境变量

    • 创建一个 .env 在项目根目录中创建文件，并添加所需的变量（见下文）。

  5. 运行代理

    python agent.py

基本环境变量

变量名称 描述 示例值
NOTION_API_TOKEN 来自您的Notion集成的令牌 secret_xxx
MCP_SERVER_URL Notion MCP服务器的URL https://mcp.notion.so
GOOGLE_Gemini_API_KEY 您的Gemini API密钥 AIza...
MODEL_NAME 使用LLM（例如Gemini、GPT-4） gemini-pro
AGENT_NAME 您的代理人姓名 notion-agent
PORT 运行代理服务器的端口 8080

注：
如果为多个用户部署，请确保每个会话使用正确的用户特定会话 NOTION_API_TOKEN 以避免会话冲突[4]。

特性

  • 读取、查询和更新Notion数据库和页面。
  • 分析数据并从Notion内容中提取见解。
  • 自动化重复的Notion工作流程。
  • 易于扩展，可与其他MCP兼容工具连接。

相关 MCP