Not MCP 服务器
模型上下文协议 (MCP) 服务器,提供与 Notion 的无缝集成。该服务器支持语言模型通过标准化工具与您的 Notion 工作区进行交互,用于搜索、读取、创建和更新页面及数据库。
🌟 主要特点
页面操作
🔍 搜索你的 Notion 工作区
📝 创建具有丰富 Markdown 内容的新页面
📖 以清晰的格式阅读页面内容
🔄 更新现有页面
💬 添加和检索评论
🧱 块级操作(更新、删除)
增强 Markdown 支持
多标题级别(H1-H3)
具有语言支持的代码块
具有复选框状态的交互式待办事项
支持多行的块引用
水平分隔线
带标题的图片
嵌套项目符号
数据库操作
创建和管理数据库
添加和更新数据库项目
使用过滤器和排序进行查询
支持各种属性类型:
标题、富文本、编号
选择、多选
日期、复选框
还有更多!
Related MCP server: Notion MCP Server
🚀 入门
先决条件
安装
克隆存储库:
git clone https://github.com/v-3/notion-server.git
cd notion-server
安装依赖项:
设置您的环境:
# 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
构建服务器:
🔧 配置
Claude 桌面设置
更新您的 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"
}
}
}
}
重新启动 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
}
🔐 设置 Notion 访问
创建集成
访问Notion Integrations
点击“新集成”
配置权限:
内容:读取、更新、插入
评论:阅读、创作
用户信息:已读
连接页面
打开你的 Notion 页面
点击“...”菜单→“连接”
添加您的集成
根据需要对其他页面重复此操作
📝 使用示例
创建页面
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"
}
}
});
🤝 贡献
欢迎投稿!请:
分叉存储库
创建功能分支
提交拉取请求
📜 许可证
该项目根据 MIT 许可证获得许可 - 有关详细信息,请参阅LICENSE文件。
🙏 致谢
sweir1/notion-server对该项目进行了显著改进,并做出了以下更新:
增强 Markdown 支持,提供更多块类型
全面的数据库操作
改进的错误处理和调试
更好地处理数据库项的属性
更清晰的页面输出格式
要使用 sweir1 的版本,您可以克隆他们的存储库:
git clone https://github.com/sweir1/notion-server.git