Not MCP 服务器

用于 Notion 集成的模型上下文协议 (MCP) 服务器实现，提供与 Notion API 交互的标准化接口。兼容 Claude Desktop 和其他 MCP 客户端。

特征

列出并查询 Notion 数据库
创建和更新页面
在 Notion 工作区中搜索
获取数据库详细信息并阻止子项
通过 httpx 提供完整的 async/await 支持
使用 Pydantic v2 模型实现类型安全
通过详细的日志记录正确处理错误
与 MCP 1.6.0 兼容

安装

克隆存储库：

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

创建虚拟环境并安装依赖项（使用 uv）：

uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
uv pip install -e .

或者，使用标准 venv：

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -e .

NOTION_API_KEY=your_notion_integration_token

用法

测试服务器（它应该正常运行）：

python -m notion_mcp

要将其与 Claude Desktop 一起使用，请调整您的claude_desktop_config.json文件（位于 macOS 上的~/Library/Application Support/Claude/claude_desktop_config.json ）：

{
  "servers": {
    "notion-mcp": {
      "command": "/Users/username/Projects/notion-mcp/.venv/bin/python",
      "args": ["-m", "notion_mcp"],
      "cwd": "/Users/username/Projects/notion-mcp"
    }
  }
}

请务必将/Users/username/替换为您的实际主目录路径。

发展

项目结构

notion-mcp/
├── src/
│   └── notion_mcp/
│       ├── models/
│       │   ├── __init__.py
│       │   └── notion.py      # Pydantic models for Notion objects
│       ├── __init__.py        
│       ├── __main__.py        # Entry point
│       ├── client.py          # Notion API client
│       └── server.py          # MCP server implementation
├── .env                       # Environment variables (add your Notion API key here)
├── .gitignore
├── pyproject.toml             # Project dependencies
└── README.md

运行测试

pytest

配置

服务器需要 Notion 集成令牌。设置方法如下：

前往https://www.notion.so/my-integrations
创建具有适当功能的新集成（根据需要读/写）
复制集成令牌
将其添加到项目根目录中的.env文件中：

NOTION_API_KEY=your_notion_integration_token

通过集成共享您的 Notion 数据库（从数据库的“共享”菜单）

贡献

分叉存储库
创建你的功能分支（ git checkout -b feature/amazing-feature ）
提交您的更改（ git commit -m 'Add some amazing feature' ）
推送到分支（ git push origin feature/amazing-feature ）
打开拉取请求

执照

MIT 许可证 - 使用风险自负

故障排除

常见问题

连接错误：请确保您的 Notion API 密钥正确并且您可以访问互联网
权限错误：确保您的集成已获得您尝试访问的数据库的访问权限
Claude Desktop 集成：如果 Claude Desktop 未连接，请检查您的配置路径是否正确，以及服务器是否正在运行且未记录到 stdout