Simple Notion MCP Server

基本能力

产品定位

Simple Notion MCP Server 旨在提供一个轻量级的解决方案，帮助 AI 助手更高效地访问和处理 Notion 页面内容。

核心功能

• Markdown 渲染：将 Notion 页面转换为干净、易读的 Markdown 格式。
• 富文本支持：保留粗体、斜体、删除线和代码等格式。

适用场景

• AI 助手需要访问和解析 Notion 页面内容。
• 开发者需要将 Notion 页面转换为 Markdown 以便于进一步处理。

工具列表

• get_page：通过 ID 获取 Notion 页面并将其渲染为 Markdown。
• 参数：page_id（Notion 页面的 ID）
• 示例： json { "page_id": "83c75a5b7a324be29d454536f2345678" }

常见问题解答

• 支持的操作：目前仅支持获取页面内容，不支持更新或创建页面。
• 图片处理：未来可能会改进图片处理功能，例如将图片渲染为 base64 图像块。

使用教程

使用依赖

1. 创建一个 Notion 集成并从 https://www.notion.so/my-integrations 获取 API 令牌。
2. 将令牌设置为环境变量： bash export NOTION_TOKEN=your-notion-api-token 或者在项目中创建一个 .env 文件： NOTION_TOKEN=your-notion-api-token
3. 确保将你想要访问的任何 Notion 页面与你的集成共享。

安装教程

1. 使用 VS Code 时，将以下内容添加到你的设置 JSON 文件中： json { "mcp": { "inputs": [ { "type": "promptString", "id": "notion_token", "description": "Notion API Token", "password": true } ], "servers": { "notion": { "command": "npx", "args": [ "-y", "@larryhudson/simple-notion-mcp-server" ], "env": { "NOTION_TOKEN": "${input:notion_token}" } } } } }
2. 使用 Claude 或其他 MCP 兼容应用程序时，将以下内容添加到你的 MCP 配置 JSON 文件中： json { "mcpServers": { "notion": { "command": "npx", "args": ["-y", "@larryhudson/simple-notion-mcp-server"], "env": { "NOTION_TOKEN": "<YOUR_NOTION_API_TOKEN>" } } } }

调试方式

使用 Model Context Protocol 检查器来测试服务器：

npx @modelcontextprotocol/inspector npx tsx src/index.ts

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。