Notion Knowledge Base MCP Server

Notion 知识库 MCP 服务

一个通过 Cline VSCode 扩展访问 Notion 知识库的 MCP 服务。

功能

• 直接从 Cline 查询 Notion 知识库
• 获取详细回答，并附上 Notion 页面引用
• 使用 FastMCP 构建，性能可靠
• 完善的错误处理和日志记录

前置条件

• Python 3.10 或更高版本
• uv 包管理器
• Cline VSCode 扩展
• 用于访问 Notion 知识库的 Dify API 密钥

安装

1. 克隆此仓库：

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

2. 创建 .env 文件并填入 Dify API 密钥：

   echo "DIFY_API_BACKEND_KEY=your-api-key-here" > .env
   

3. 在 Cline 中安装服务：

   fastmcp install notion_mcp_server.py
   

   这将自动：

   • 使用 uv 安装所有必需的依赖项
   • 在 Cline 的设置中配置服务
   • 使服务可供 Cline 使用

使用方法

安装后，你可以在 Cline 中通过询问有关 Notion 知识库的问题来使用此服务。例如：

Tell me about internal tooling

服务将使用 Notion 知识库中的相关信息作答，包括：

• 详细回答
• 相关 Notion 页面的链接
• 供参考的页面 ID

配置

服务会在安装期间自动配置，但如果需要，你也可以手动更新 Cline 配置文件中的设置：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

配置示例：

{
  "mcpServers": {
    "notion-kb": {
      "command": "uv",
      "args": [
        "run",
        "--with", "fastmcp",
        "--with", "python-dotenv",
        "--with", "requests",
        "fastmcp",
        "run",
        "/absolute/path/to/notion_mcp_server.py"
      ],
      "env": {
        "DIFY_API_BACKEND_KEY": "your-api-key"
      }
    }
  }
}

开发

用于开发和测试：

1. 安装依赖项：

   pip install -r requirements.txt
   

2. 运行开发服务：

   fastmcp dev notion_mcp_server.py
   

这将启动 MCP Inspector 界面，以便测试服务。

故障排除

1. 服务无法连接

   • 检查 .env 文件中的 API 密钥
   • 确保 Cline 配置中的服务路径为绝对路径
   • 检查是否已安装 uv，且其位于 PATH 中

2. 依赖项问题

   • 尝试使用 fastmcp install notion_mcp_server.py --force 重新安装
   • 检查 uv 是否已正确安装

3. 服务无响应

   • 确保使用配置中指定的 uv run 命令
   • 检查服务日志中的错误

贡献

有关服务实现和架构的详细信息，请参阅 mcp_instructions.md。

许可证

MIT