项目简介

Notion MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在为大型语言模型（LLM）客户端提供与 Notion 集成的标准化接口。通过此服务器，LLM 可以安全、便捷地访问和操作 Notion 中的数据，从而扩展 LLM 的上下文理解和应用能力。

主要功能点

数据库操作：
- 列出所有可访问的 Notion 数据库。
- 查询数据库中的条目，支持筛选和排序。
页面操作：
- 在指定数据库中创建新的页面。
- 更新现有页面的属性和内容。
工作区搜索：
- 在整个 Notion 工作区中执行内容搜索。

安装步骤

克隆仓库

git clone https://github.com/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 integration token：
```
NOTION_API_KEY=your_notion_integration_token
```
  您需要在 Notion 官方网站创建一个新的 integration 并获取 token。

服务器配置

对于 MCP 客户端（例如 Claude Desktop），您需要配置服务器连接信息。以下是一个 'claude_desktop_config.json' 示例配置，您需要根据实际情况修改路径：

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

注意：

'command' 字段应指向您在安装步骤中创建的虚拟环境中的 Python 解释器。
'cwd' 字段应指向您克隆的 'notion-mcp' 项目的根目录。

基本使用方法

配置完成后，MCP 客户端将能够通过 "notion-mcp" 这个服务器名称与此 Notion MCP Server 建立连接。客户端可以调用服务器提供的工具（如 'list_databases', 'query_database', 'create_page', 'update_page', 'search'）来执行相应的 Notion 操作。具体工具的使用方法请参考 MCP 客户端的文档。

例如，在 Claude Desktop 中，您可以指示 Claude 使用 "notion-mcp" 服务器提供的工具来查询 Notion 数据库或创建新的页面。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息