Notion MCP 服务器指南

概述

MCP（Multipurpose Control Panel）服务器是一个用于与Notion接口交互的强大工具，支持多种操作，包括创建、读取、更新和删除数据库项，管理用户，以及处理评论等。本文将详细介绍如何设置、使用和集成MCP服务器，并附有完整的中文翻译。

设置指南

1. 安装依赖

在开始之前，请确保安装以下Python库：

• notion：用于与Notion API交互。
• flask：用于创建Web界面（可选）。

运行以下命令进行安装：

pip install notion python-dotenv flask

2. 初始化项目结构

创建一个新目录，并在其中添加以下文件：

• config.py：存储配置信息，如Notion API密钥和数据库ID。
• mcp_server.py：主服务器文件，包含MCP接口的实现。
• requirements.txt：列出所有依赖项。

3. 配置环境变量

在config.py中添加以下内容：

NOTION_TOKEN = "your_notion_token"
DATABASE_ID = "your_database_id"

快速上手

1. 创建MCP实例

使用默认配置创建MCP服务器：

from mcp_server import MCP

mcp = MCP()

2. 启动服务器

运行以下命令启动MCP服务器：

python mcp_server.py

默认情况下，服务器将在http://localhost:5000上运行。

功能列表

以下是MCP服务器支持的主要功能及其详细说明：

1. 创建页面

   • 描述：在Notion工作区中创建新页面。
   • 参数：
     • title：必需，类型为字符串。
     • parent_page_id：可选，指定父页面的ID。

2. 读取页面内容

   • 描述：获取指定页面的内容和属性。
   • 参数：
     • page_id：必需，类型为字符串。

3. 更新页面属性

   • 描述：更新现有页面的属性或内容。
   • 参数：
     • page_id：必需，类型为字符串。
     • properties：可选，字典格式，包含要更新的属性和值。

4. 删除页面

   • 描述：从Notion工作区中删除指定页面。
   • 参数：
     • page_id：必需，类型为字符串。

5. 创建数据库条目

   • 描述：在指定的Notion数据库中创建新条目。
   • 参数：
     • database_id：必需，类型为字符串。
     • properties：必需，字典格式，包含条目的属性和值。

6. 读取数据库内容

   • 描述：获取指定数据库的所有条目。
   • 参数：
     • database_id：必需，类型为字符串。
     • page_size：可选，整数，指定每页显示的条目数量。

7. 更新数据库条目

   • 描述：更新现有数据库条目的属性或内容。
   • 参数：
     • database_id：必需，类型为字符串。
     • entry_id：必需，类型为字符串。
     • properties：可选，字典格式，包含要更新的属性和值。

8. 删除数据库条目

   • 描述：从指定数据库中删除特定条目。
   • 参数：
     • database_id：必需，类型为字符串。
     • entry_id：必需，类型为字符串。

9. 搜索内容

   • 描述：在Notion工作区中搜索页面、数据库和评论。
   • 参数：
     • query：可选，字符串，指定搜索关键词。
     • filter：可选，字典格式，用于限制搜索范围（如仅限于页面或数据库）。

10. 管理用户

    • 描述：列出所有用户、获取特定用户的详细信息以及创建新用户。
    • 参数：
      • user_id：可选，类型为字符串。
      • username：可选，类型为字符串。
      • email：可选，类型为字符串。

11. 处理评论

    • 描述：在页面上创建、读取、更新和删除评论。
    • 参数：
      • page_id：必需，类型为字符串。
      • comment_id：可选，类型为字符串。
      • content：必需，类型为字符串。

教程

1. 创建新页面

以下是一个创建新页面的示例代码：

mcp.create_page(title="My New Page", parent_page_id="parent_page_id")

2. 更新现有页面属性

更新页面属性的示例代码如下：

properties = {
    "Status": "Published",
    "Priority": "High"
}
mcp.update_page_properties(page_id="page_id", properties=properties)

3. 搜索内容

搜索Notion工作区中的内容，可以使用以下代码：

results = mcp.search_content(query="search_term")
for result in results:
    print(result.title, result.type)

错误处理

MCP服务器提供了详细的错误处理机制，包括验证错误、授权错误和网络错误。所有错误都会抛出相应的异常，并附带错误信息。

示例

try:
    mcp.create_page(title="", parent_page_id="parent_id")
except ValueError as e:
    print(e)

许可证

MCP服务器遵循MIT许可证，允许您自由使用、修改和分发该软件。完整的许可内容如下：

MIT License

版权所有 (c) [年份] [姓名]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

贡献指南

我们欢迎社区的贡献！如果您发现任何问题或有任何改进想法，请访问我们的GitHub仓库提交Issue或Pull Request。

如何贡献

1. Fork 该项目。
2. 创建新的功能分支。
3. 提交您的更改。
4. Push 到远程仓库并创建Pull Request。

联系我们

如果您有任何问题或反馈，请联系我们的开发团队：

• 邮件：contact@notionmcp.com
• GitHub：https://github.com/notionmcp

感谢您选择MCP服务器！希望它能为您的Notion项目带来便利。