Notion MCP 服务器

一个用于 Notion 集成的模型上下文协议 (MCP) 服务器实现，为与 Notion 的 API 交互提供了一个标准化的接口。

特性

• 列出和查询 Notion 数据库
• 创建和更新页面
• 搜索整个 Notion 工作区
• 完整的 async/await 支持
• 使用 Pydantic 模型进行类型安全
• 适当的错误处理

安装

1. 克隆仓库：

git clone https://github.com/ccabanillas/notion-mcp.git
cd notion-mcp

2. 创建一个虚拟环境并安装依赖项：

python -m venv venv
source venv/bin/activate  # 在 Windows 上：venv\Scripts\activate
pip install -e .

3. 在项目根目录中创建一个 .env 文件：

NOTION_API_KEY=your_notion_integration_token

用法

1. 测试服务器（它应该直接运行而没有错误）：

python -m notion_mcp

2. 要按照预期与 Claude Desktop 实际使用它，您需要调整您的 claude_desktop_config.json 文件

"notion-mcp": {
            "command": "/Users/username/Projects/notion-mcp/venv/bin/python3", <-- 您的虚拟环境路径
            "args": ["-m", "notion_mcp"],
            "cwd": "/Users/username/Projects/notion-mcp" <-- 您的项目路径
    },

开发

项目结构

notion-mcp/
├── src/
│   └── notion_mcp/
│       ├── models/
│       │   ├── __init__.py
│       │   └── notion.py
│       ├── __init__.py
│       ├── __main__.py
│       ├── client.py
│       └── server.py
├── .env
├── .gitignore
├── pyproject.toml
└── README.md

运行测试

pytest

配置

服务器需要一个 Notion 集成令牌。 要设置它：

1. 转到 https://www.notion.so/my-integrations
2. 创建一个新的集成
3. 复制集成令牌
4. 将其添加到您的 .env 文件

贡献

1. Fork 仓库
2. 创建您的功能分支 (git checkout -b feature/amazing-feature)
3. 提交您的更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request

许可证

MIT 许可证 - 使用风险自负

致谢

• 构建用于与 Claude Desktop 一起工作
• 使用 Notion 的 API
• 特别感谢 [danhilse]，我参考了他的 notion-mcp-server 项目