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执行操作。
______________________________________________________________________
安装说明
- 克隆存储库
git clone https://github.com/maskedwolf4/Notion-MCP-ADK-Agent
cd Notion-MCP-ADK-Agent- 安装依赖项
pip install -r requirements.txt- 创建概念集成
- 首选 概念开发者 并创建新的集成。 - 保存生成的Notion API令牌。
- 配置环境变量
- 创建一个 .env 在项目根目录中创建文件，并添加所需的变量（见下文）。
- 运行代理
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兼容工具连接。
______________________________________________________________________