Notion MCP Server 使用说明

项目简介

Notion MCP Server 是一个专门为 Notion 设计的 MCP 服务器，它充当大型语言模型 (LLM) 客户端和 Notion 之间的桥梁。通过这个服务器，LLM 可以安全、标准地访问和操作 Notion 中的信息，实现知识库的集成和自动化工作流。

主要功能点

查询 Notion 数据库：允许 LLM 检索 Notion 数据库中的信息，支持筛选和排序。
创建和更新 Notion 页面：支持 LLM 在 Notion 中创建新的页面，或更新现有页面的属性和内容。
在 Notion 工作区中搜索：使 LLM 能够搜索整个 Notion 工作区的内容，快速找到所需信息。
异步操作：服务器采用异步设计，确保高效和非阻塞的运行。
类型安全：使用 Pydantic 模型进行数据验证，提高代码的健壮性。
完善的错误处理：提供清晰的错误信息，方便调试和问题排查。

安装步骤

克隆仓库

git clone https://github.com/MCP-Mirror/ccabanillas_notion-mcp.git
cd notion-mcp

创建虚拟环境并安装依赖

python -m venv venv
source venv/bin/activate   # Linux/macOS
# venv\Scripts\activate  # Windows
pip install -e .

配置 Notion API 密钥
- 在项目根目录下创建 '.env' 文件。
- 在 '.env' 文件中添加你的 Notion 集成令牌：
```
NOTION_API_KEY=你的Notion集成令牌
```
  如何获取 Notion 集成令牌:
  1. 访问 https://www.notion.so/my-integrations
  2. 创建一个新的集成。
  3. 复制生成的集成令牌。

服务器配置

对于 MCP 客户端（例如 Claude Desktop），你需要配置服务器的启动命令。以下是一个示例 'claude_desktop_config.json' 配置片段，你需要根据你的实际环境进行调整：

"notion-mcp": {
    "command": "/path/to/your/venv/bin/python3",  // 替换为你的虚拟环境中 python3 的路径
    "args": ["-m", "notion_mcp"],
    "cwd": "/path/to/your/notion-mcp-project"   // 替换为你的 notion-mcp 项目的根目录
}

配置参数说明:

'"command"': 指向 Python 解释器的路径，务必使用你在安装步骤中创建的虚拟环境中的 Python 解释器。
'"args"': 启动服务器的参数，固定为 '["-m", "notion_mcp"]'。
'"cwd"': 服务器的工作目录，设置为你的 'notion-mcp' 项目的根目录。

请根据你的实际环境，修改 '/path/to/your/venv/bin/python3' 和 '/path/to/your/notion-mcp-project' 为正确的路径。

基本使用方法

启动服务器: 配置好 'claude_desktop_config.json' 后，当 MCP 客户端尝试连接名为 '"notion-mcp"' 的服务器时，就会根据你配置的命令启动 Notion MCP Server。
在 MCP 客户端中使用工具: 服务器启动后，MCP 客户端可以列出并调用服务器提供的工具，例如：
- 'list_databases': 列出所有可访问的 Notion 数据库。
- 'query_database': 查询指定 Notion 数据库中的条目。
- 'create_page': 在指定的 Notion 数据库中创建新页面。
- 'update_page': 更新指定 Notion 页面的属性。
- 'search': 在 Notion 中执行搜索。
具体的工具调用和参数设置，请参考 MCP 客户端的文档和工具的 'inputSchema' 定义。服务器会在接收到客户端的工具调用请求后，与 Notion API 交互，并将结果返回给客户端。

注意: 首次使用前，请确保你已正确配置 Notion 集成令牌，并且该集成已被添加到你希望访问的 Notion 工作区中。

关键词