Notion Server

MCP服务器概念

提供与Notion无缝集成的模型上下文协议（MCP）服务器。此服务器使语言模型能够通过用于搜索、阅读、创建和更新页面和数据库的标准化工具与您的Notion工作区进行交互。

🌟 主要特点

页面操作

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

增强的Markdown支持

• 多个航向级别（H1-H3）
• 支持语言的代码块
• 带有复选框状态的交互式待办事项
• 支持多行的Blockquotes
• 水平分隔器
• 带字幕的图像
• 嵌套的要点

数据库操作

• 创建和管理数据库
• 添加和更新数据库项
• 使用过滤器和排序进行查询
• 支持多种物业类型：

- 标题、富格文本、数字 - 选择，多选 - 日期，复选框 - 还有更多！

🚀 入门指南

先决条件

• Node.js（v16或更高版本）
• 通知API密钥
• MCP兼容客户端（例如Claude Desktop）

安装

1. 克隆存储库：

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

1. 安装依赖项：

npm install

1. 设置您的环境：

# Create .env file
echo "NOTION_API_KEY=your_notion_api_key_here" > .env

# Or export directly
export NOTION_API_KEY=your_notion_api_key_here

1. 构建服务器：

npm run build

🔧 配置

Claude桌面设置

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"
            }
        }
    }
}

1. 重新启动Claude Desktop以应用更改

🛠️ 可用工具

页面操作

// Search pages
{
    query: string // Search query
}

// Read page
{
    pageId: string // ID of the page to read
}

// Create page
{
    title?: string,      // Page title
    content?: string,    // Page content in markdown
    parentPageId: string // Parent page ID
    properties?: object  // For database items
}

// Update page
{
    pageId: string,   // Page ID to update
    content: string,  // New content
    type?: string    // Content type
}

数据库操作

// Create database
{
    parentPageId: string,
    title: string,
    properties: object
}

// Query database
{
    databaseId: string,
    filter?: object,
    sort?: object
}

🔐 设置通知访问

创建集成

1. 访问 概念整合
2. 点击“新建集成”
3. 配置权限：

- 内容：阅读、更新、插入 - 评论：阅读，创建 - 用户信息：阅读

连接页面

1. 打开您的Notion页面
2. 点击“…”菜单→ “连接”
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. 分叉存储库
2. 创建要素分支
3. 提交拉取请求

📜 许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

🙏 致谢

通过以下方式，该项目得到了显著改善 sweir1/概念服务器，已进行以下更新：

• 通过更多块类型增强标记支持
• 全面的数据库操作
• 改进了错误处理和调试
• 更好地处理数据库项的属性
• 更清晰的页面输出格式

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

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