Mcp Notion

🚀 浏览整个 Notion 工作区，而不仅仅是单个数据库

本项目基于 Markdown 技术，借助单一的 ROOT_PAGE 变量，实现了对 Notion 工作区的全局浏览，且无需使用令牌。它是一个用于管理并与 Notion 基于笔记的 Model Context Protocol (MCP) 服务器。此 TypeScript 实现充分展示了 MCP 的概念，通过集成资源、工具和提示，能够高效地与 Notion 页面进行交互。

🚀 快速开始

开发设置

• 安装依赖：

pnpm install

• 构建项目：

pnpm build

• 开发模式自动重建：

pnpm watch

配置

若要将服务器配置为与 Notion 协同工作，需设置环境变量：

• ROOT_PAGE：你的 Notion 工作区根页面 ID。

安装用于 Claude Desktop

若要在 Claude Desktop 上使用此服务器，需添加以下配置：

• MacOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json

示例配置如下：

{
"mcpServers": {
"notion-texonom": {
"command": "node",
"args": [
"/path/to/mcp/build/index.js"
],
"env": {
"ROOT_PAGE": "$SOME_UUID"
}
}
}
}

调试

若要调试和排除 MCP 服务器问题，可使用 MCP 检查器。启动检查器的命令如下：

pnpm inspector

检查器提供了一个基于浏览器的界面，用于检查标准输入输出的服务器通信。

远程部署

当前服务器使用 SSEServerTransport 实现远程通信，支持共享服务器的使用。请确保安装必要的依赖项，并正确配置服务器以进行远程部署。

使用说明

若要使用 SSEServerTransport 运行服务器，请运行以下命令：

npx -y supergateway --port 8000 --stdio "npx -y @modelcontextprotocol/server-filesystem /some/folder"

请将 /some/folder 替换为适当的路径。

✨ 主要特性

资源

• 访问笔记：可列出并检索 Notion 页面作为 note:// URI，且附带 UUID 标记。
• 元数据：每个资源包含标题、描述和 Markdown 格式的正文内容。
• MIME 类型：正文内容可通过 text/markdown 格式访问。

工具

• 搜索笔记：使用 search_notes 工具，可通过查询字符串搜索 Notion 页面。
  • 输入：用于过滤相关页面的查询文本。
  • 输出：匹配笔记的 Markdown 内容。

提示

• 总结笔记：可为特定 Notion 页面生成摘要。
  • 可用提示：
    • summarize_note：通过 URI 摘要指定笔记。
    • suggest_refactor：提出结构改进的建议。
    • suggest_fix：识别潜在修复内容。
    • suggest_enhance：推荐增强以提高笔记质量。
  • 输入：Notion 页面 URI。
  • 输出：摘要和改进的结构化消息。

🔧 技术细节

• Notion 集成：由 @texonom/nclient 和 @texonom/cli 提供支持。
• MCP SDK：实现 @modelcontextprotocol/sdk 用于服务器操作。