Notion MCP 服务器

一个模型上下文协议 (MCP) 服务器，提供与 Notion 的无缝集成。该服务器使语言模型能够通过标准化的工具与您的 Notion 工作区进行交互，以进行搜索、读取、创建和更新页面和数据库。

🌟 主要特性

页面操作

• 🔍 搜索您的 Notion 工作区
• 📝 创建具有丰富 Markdown 内容的新页面
• 📖 以清晰的格式读取页面内容
• 🔄 更新现有页面
• 💬 添加和检索评论
• 🧱 块级操作（更新、删除）

增强的 Markdown 支持

• 多个标题级别 (H1-H3)
• 带有语言支持的代码块
• 带有复选框状态的交互式待办事项
• 带有多行支持的块引用
• 水平分隔线
• 带有标题的图像
• 嵌套的要点

数据库操作

• 创建和管理数据库
• 添加和更新数据库条目
• 使用过滤器和排序进行查询
• 支持各种属性类型：
  • 标题、富文本、数字
  • 选择、多选
  • 日期、复选框
  • 还有更多！

🚀 快速开始

前提条件

• Node.js (v16 或更高版本)
• Notion API 密钥
• 兼容 MCP 的客户端（例如，Claude Desktop）

安装

1. 克隆存储库：

git clone https://github.com/v-3/notion-server.git
cd notion-server

2. 安装依赖项：

npm install

3. 设置您的环境：

# 创建 .env 文件
echo "NOTION_API_KEY=your_notion_api_key_here" > .env

# 或者直接导出
export NOTION_API_KEY=your_notion_api_key_here

4. 构建服务器：

npm run build

🔧 配置

Claude Desktop 设置

1. 更新您的 Claude Desktop 配置 (claude_desktop_config.json):

{
    "mcpServers": {
        "notion": {
            "command": "node",
            "args": ["/absolute/path/to/notion-server/build/index.js"],
            "env": {
                "NOTION_API_KEY": "your_notion_api_key_here"
            }
        }
    }
}

2. 重启 Claude Desktop 以应用更改

🛠️ 可用工具

页面操作

// 搜索页面
{
    query: string // 搜索查询
}

// 读取页面
{
    pageId: string // 要读取的页面的 ID
}

// 创建页面
{
    title?: string,      // 页面标题
    content?: string,    // 页面内容，使用 markdown 格式
    parentPageId: string // 父页面 ID
    properties?: object  // 用于数据库条目
}

// 更新页面
{
    pageId: string,   // 要更新的页面 ID
    content: string,  // 新内容
    type?: string    // 内容类型
}

数据库操作

// 创建数据库
{
    parentPageId: string,
    title: string,
    properties: object
}

// 查询数据库
{
    databaseId: string,
    filter?: object,
    sort?: object
}

🔐 设置 Notion 访问权限

创建集成

1. 访问 Notion Integrations
2. 点击 "New integration"
3. 配置权限：
   • 内容：读取、更新、插入
   • 评论：读取、创建
   • 用户信息：读取

连接页面

1. 打开您的 Notion 页面
2. 点击 "..." 菜单 → "Connections"
3. 添加您的集成
4. 根据需要为其他页面重复此操作

📝 使用示例

创建页面

const result = await notion.create_page({
  parentPageId: "page_id",
  title: "My Page",
  content: "# Welcome\nThis is a test page."
});

查询数据库

const result = await notion.query_database({
  databaseId: "db_id",
  filter: {
    property: "Status",
    select: {
      equals: "In Progress"
    }
  }
});

🤝 贡献

欢迎贡献！请：

1. Fork 存储库
2. 创建一个功能分支
3. 提交 Pull Request

📜 许可证

本项目根据 MIT 许可证授权 - 有关详细信息，请参阅 LICENSE 文件。

🙏 鸣谢

本项目的改进很大程度上归功于 sweir1/notion-server，他进行了以下更新：

• 增强了 Markdown 支持，增加了更多块类型
• 完善的数据库操作
• 改进的错误处理和调试
• 更好的数据库条目属性处理
• 更清晰的页面输出格式

要使用 sweir1 的版本，您可以克隆他们的存储库：

git clone https://github.com/sweir1/notion-server.git