MCP Notion Interface

AutoGen MCP概念工作区代理

一个生产就绪的代理人工智能系统，通过模型上下文协议（MCP）将Notion工作空间管理与Microsoft AutoGen多代理框架集成在一起。

实时应用程序

前端: https://mcp-notion-chatbot.lovable.app\ 后端：通过ngrok动态隧道传输（见部署部分）

Frontend Interface

架构概述

该项目展示了以下方面的先进实施：

• 模型上下文协议（MCP） 用于标准化工具集成
• 微软AutoGen 多智能体对话式人工智能
• 异步Python 具有适当并发处理的架构
• 生产部署 ngrok隧道

系统组件

Frontend (Lovable) → ngrok Tunnel → Flask API → AutoGen Agent → MCP Tools → Notion API

System Workflow

Detailed Architecture with Tunneling

技术实现

MCP集成

• MCP服务器: https://mcp.notion.com/mcp 通过 mcp-remote
• 协议：基于标准的MCP服务器通信
• 工具：从Notion MCP服务器动态发现和注册工具
• 认证：基于安全令牌的Notion工作区访问

代理体系结构

• 框架：带有AssistantAgent实现的Microsoft AutoGen
• 团队：RoundRobinGroupChat，对话限制为5轮
• 模型：OpenAI GPT-4o通过 autogen-ext OpenAI客户端
• 终止：基于文本的终止条件（“TERMINATE”）
• 反思：启用了工具使用反思，以改进决策

异步架构

# Proper async chain implementation
Flask (sync) → asyncio.run() → AutoGen Team → MCP Tools → Notion API

项目结构

├── main.py                     # Flask API server with ngrok tunneling
├── .env.example                # Environment variables template
├── pyproject.toml              # UV dependency management
├── uv.lock                     # Dependency lock file
├── agents/
│   └── notion_agent.py         # AutoGen AssistantAgent configuration
├── teams/
│   └── notion_team.py          # RoundRobinGroupChat team setup
├── MCP/
│   └── notion_mcp_tools.py     # MCP server connection and tool registration
├── models/
│   └── openai_model_client.py  # OpenAI client configuration
├── config/
│   ├── settings.py             # Environment configuration
│   └── prompt/
│       └── system_prompt.py    # Agent system message
└── images/
    ├── frontend_ui.png         # Frontend interface screenshot
    ├── workflow.png            # System workflow diagram
    └── detailed_workflow_tunnelling.png  # Detailed architecture diagram

API终点

POST/运行

通过Notion代理执行任务

{
  "task": "create a page named 'Project Timeline'"
}

回应:

{
  "status": "success",
  "result": "Agent conversation stream output"
}

GET/健康

健康检查端点

设置和部署

安装

# Clone repository
git clone 
cd MCP-Notion-Project

# Install dependencies
uv sync

# Configure environment
cp .env.example .env
# Add your tokens: NOTION_TOKEN, OPENAI_API_KEY, NGROK_AUTH_TOKEN

发展

uv run main.py

该应用程序将：

1. 在端口7001上启动Flask服务器
2. 修建ngrok隧道供公众通行
3. 连接到Notion MCP服务器
4. 使用MCP工具初始化AutoGen代理

生产部署

您的本地计算机通过ngrok隧道充当生产服务器，在保持本地开发灵活性的同时实现公共访问。