AI导哈

Notion AI助手

NotionMCP 是一个通过 MCP 协议提供高级 Notion 搜索、阅读、总结和情感分析功能的 AI 助手，适用于开发者和知识密集型团队。

  • by DeepActionPotential
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 DeepActionPotential/NotionMCP

使用说明

NotionMCP——基于MCP的人工智能概念助手

概念MCP是 模块化上下文协议（MCP）服务器 它将高级的Notion搜索、阅读、摘要和情感分析工具暴露给任何兼容MCP的LLM客户端，例如 克劳德桌面版.

该项目将您的Notion工作空间变成一个智能、可查询的知识系统，使您的AI助手能够：

  • 精确搜索页面和数据库
  • 读取并提取块级内容
  • 总结大型或复杂的Notion页面
  • 分析页面文本的情感
  • 基于您的Notion数据构建人工智能工作流程
  • 使用MCP标准安全操作

它是为以下目的而建造的：

  • 开发者
  • 研究人员
  • 数据科学团队
  • 知识密集型组织
  • 任何想要与Notion深度集成的AI代理的人

特性

智能概念搜索

  • 标题搜索
  • 页面/数据库过滤
  • 分页+流媒体搜索
  • 用户发现工具

高级内容阅读

  • 从页面中提取可读文本
  • 横向块体结构
  • 按名称或ID读取页面
  • 支持标题、列表、复选框、标注、引号等。

人工智能总结与情绪分析

  • 摘要（T5）
  • 情绪/音调分类（变形金刚）
  • 集成到Notion工作流中

完全兼容MCP

开箱即用：

  • 克劳德桌面版
  • ChatGPT MCP模式
  • 任何与MCP兼容的自动化或代理

干净的模块化架构

  • search_tools.py
  • read_tools.py
  • ai_tools.py
  • 异步通知客户端层，具有重试+速率限制处理

商业价值

NotionMCP将Notion从文档空间升级为 可扩展的人工智能知识引擎. 它使团队和组织能够更快地运作，减少人工开销，并通过将非结构化笔记转化为可操作的情报来做出更好的决策。

对于组织

  • 自动化摘要、研究、入职和文档工作流程
  • 提高跨团队和部门的知识可访问性
  • 规范信息的使用、汇总和共享方式
  • 减少搜索或重写内容所花费的操作时间
  • 构建能够检索、处理和分析公司知识的内部人工智能代理

技术团队

  • 通过重试+退避处理获得强大的异步Notion API客户端
  • 使用自定义AI模型或内部逻辑扩展MCP工具
  • 将Notion集成到更广泛的人工智能、分析或自动化管道中
  • 在Notion页面上构建可复制和自动化的工作流程
  • 通过在本地运行工具来保持对数据的完全控制

战略成果

  • 更快的决策
  • 减少技术和非技术团队的认知负荷
  • 更强的组织记忆和知识一致性
  • 基于真实公司数据的可部署AI助手的基础

演示

视频演示

点击查看 ./demo/1.mp4

图像漫游

安装

您可以使用以下任一方式安装：

选项A——使用 venv （推荐给大多数用户）

1.克隆存储库

git clone https://github.com/DeepActionPotential/NotionMCP.git
cd NotionMCP

2.创建并激活虚拟环境

python -m venv .venv

激活它：

视窗

.venv\Scripts\activate

macOS/Linux

source .venv/bin/activate

3.安装依赖项

pip install -r requirements.txt

4.运行MCP服务器

python server.py

选项B——使用 uv

uv sync
uv run server.py

配置Claude桌面

添加以下内容：

claude_desktop_config.json

{
  "mcpServers": {
    "NotionMCPServer": {
      "command": "uv",
      "args": [
        "--directory",
        "your-own-server-file-directory",
        "run",
        "server.py"
      ]
    }
  }
}

重新启动克劳德桌面。 现在，您应该可以在MCP工具菜单下看到所有可用的Notion工具。

环境变量

创建一个 .env 文件或导出环境变量：

NOTION_API_KEY=secret_notion-api
HTTP-TIMEOUT=60

您的Notion集成必须与您要阅读的页面或工作区共享。

使用示例

问克劳德：

  • “在Notion中搜索有关卷积的页面。”
  • “用200字概括深度学习页面。”
  • “提取度量页面的前20行。”
  • “分析视觉页面的情感基调。”

Claude将自动调用MCP工具，例如：

  • search
  • iter_search
  • get_page_text
  • summarize_page_text
  • get_page_sentiment

建筑

NotionMCP
│
├── tools/
│   ├── search_tools.py
│   ├── read_tools.py
│   └── ai_tools.py
│
├── core/
│   └── notion_clients.py
│
├── services/
│   ├── summarization_service.py
│   └── text_emotion_service.py
│
├── demo/
│
└── server.py

贡献

欢迎捐款：

  • 新的人工智能模型
  • 其他概念端点
  • 性能改进
  • 新的MCP工具

请打开问题或提交PR。

许可证

MIT许可证——商业和私人使用免费。

相关 MCP