Notion MCP工具集

一个用于通过Model Context Protocol (MCP)服务器与Notion交互的Python脚本集合,提供数据库列表、查询票证、更新页面标题/描述等功能。

  • by MMcCuen
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 mmccuen/notion_mcp

使用说明

该项目不隶属于Notion。使用风险自负。

官方公告/MCP Github可以找到->https://github.com/makenotion/notion-mcp-server?tab=readme-ov文件。

注意:此repo特定于我如何设置我的概念。你的可能看起来不一样,可能需要一些推特。快乐编码!

MCP实用程序概念

一组Python脚本,用于通过模型上下文协议(MCP)服务器与Notion交互。这些工具允许您使用Notion MCP Docker镜像列出数据库、查询票证、更新页面标题/描述以及探索Notion工作区资源。

特性

  • 列出概念数据库:发现Notion工作区中的所有数据库,并确定跟踪票证或问题的位置。
  • 查询已优化的门票:在特定的“精炼”数据库中搜索门票信息。
  • 更新页面标题和描述:根据Notion页面的ID更改其标题和描述。
  • 列出工作区内容:枚举工作区中的所有数据库和页面,包括它们的属性和示例条目。
  • 列出MCP功能:探索Notion MCP服务器提供的所有可用操作、工具和资源。
  • 查找页面ID:在数据库中找到特定条目的页面(行)ID(例如“当前门票”)。

需求

  • Python 3.7+
  • Docker(用于运行Notion MCP服务器)
  • Notion集成令牌(NOTION_TOKEN 环境变量)

设置

  1. 安装Python依赖项 (如果将来添加):

    pip install -r requirements.txt
    

    (目前,只使用标准库模块。)

  2. 设置您的Notion集成令牌:

    export NOTION_TOKEN=your_notion_secret_token
    
  3. 确保Docker正在运行 你可以拉 mcp/notion 图片:

    docker pull mcp/notion
    

用法

每个脚本都是可执行的,可以直接从命令行运行。示例用法:

  • 列出所有数据库:
    python list_databases.py
    
  • 查询精制票:
    python query_refined.py
    
  • 更新页面的标题和描述:
    python update_page_title_description.py --id <PAGE_ID> --title "New Title" --description "New description"
    
  • 列出工作区内容:
    python list_workspace.py
    
  • 列出MCP服务器功能:
    python list_mcp_capabilities.py
    
  • 查找“当前门票”的页面ID:
    python get_current_tickets_pageid.py
    

环境变量

  • NOTION_TOKEN:您的Notion集成令牌(所有脚本都需要)。

运作原理

所有脚本都通过Docker与Notion MCP服务器通信,在stdin/stdout上使用JSON-RPC。MCP服务器为Notion API提供了一个统一的接口,使其易于实现工作空间管理和数据提取的自动化。

许可证

MIT许可证


该项目不隶属于Notion。使用风险自负。