Notion (via Dify)

🚀 Notion知识库MCP服务器

Notion知识库MCP服务器可提供对Notion知识库的访问，它通过Cline VSCode扩展来实现，能让用户更便捷地查询知识库信息。

✨ 主要特性

• 可直接从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知识库。例如：

告诉我内部工具的相关信息

服务器将从你的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运行命令。
   • 检查服务器日志中的错误。

贡献

有关详细信息，请参阅mcp_instructions.md以获取服务器实现和架构的详细说明。

📄 许可证

本项目采用MIT许可证。