🚀 mcp-notion-server
这是一个用于 Notion 集成的 Model Context Protocol 服务器，它基于 TypeScript 实现了 Claude 和 Notion 之间的桥梁，可让用户与 Notion 的数据库和页面进行无缝交互。通过核心 MCP 概念，它能实现 Notion 页面和数据库的资源管理、内容的增删改查（CRUD）操作，以及基于 AI 的提示内容分析。
🚀 快速开始
这个基于 TypeScript 的 MCP 服务器搭建了 Claude 和 Notion 之间的桥梁，让用户能与 Notion 的数据库和页面无缝交互。借助核心 MCP 概念，实现了资源管理、内容操作及提示内容分析等功能。
✨ 主要特性
资源
- 通过 URI 访问 Notion 页面和数据库。
- 支持纯文本和富文本内容类型。
- 提取 Notion 属性的元数据。
工具
数据库操作
list_databases- 列出所有可访问的 Notion 数据库。create_database- 创建具有自定义属性的新数据库。query_database- 搜索和过滤数据库条目。update_database- 修改数据库属性和架构。
页面操作
create_page- 在数据库或子页面中创建新页面，支持标题、属性和 Markdown 内容。update_page- 更新现有页面属性。get_page- 获取页面内容和元数据。delete_page- 从数据库或父页面删除页面。
块操作
append_blocks- 向页面添加新块。delete_blocks- 从页面中删除块。get_blocks- 检索块内容。update_blocks- 修改现有块内容。
提示语
summarize_notes- 生成笔记的简洁摘要。analyze_content- 提供页面内容的见解和分析。suggest_tags- 根据内容推荐相关标签。
📦 安装指南
先决条件
- Node.js 18 或更高版本。
- Notion API Key 和集成设置。
- Claude Desktop 应用程序安装。
与 Claude Desktop 集成
创建一个 Notion 集成：
- 访问 Notion 的您的集成页面。
- 点击“新建集成”。
- 命名您的集成并选择适当的权限（例如，“读取内容”，“更新内容”）。
- 获取 Secret Key：复制集成的“内部 Integration Token”，这个令牌将用于身份验证。
- 将集成添加到您的工作区：在 Notion 中打开您想让集成访问的页面或数据库，点击右上角的导航按钮，点击“Connect to”按钮并选择您的集成。
配置设置
将服务器配置添加到 Claude Desktop： MacOS:
~/Library/Application Support/Claude/claude_desktop_config.json
Windows:
%APPDATA%/Claude/claude_desktop_config.json
配置内容：
{
"mcpServers": {
"mcp-notion-server": {
"command": "npx",
"args": [
"-y",
"@gabornyerges/mcp-notion-server"
],
"env": {
"NOTION_API_KEY": "your-notion-api-key"
}
}
}
}
调试
由于 MCP 服务器通过 stdio 通信，调试可能具有挑战性。我们建议使用 MCP Inspector，该工具作为包脚本可用：
- MCP Inspector
npm run inspector
📄 许可证
MIT 许可证 - 详情请参阅 LICENSE