Notion知识库MCP服务器

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

功能特性

• 直接从Cline查询您的Notion知识库
• 获取带Notion页面引用的详细答案
• 基于FastMCP构建，确保可靠性能
• 完善的错误处理与日志记录

前提条件

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

安装步骤

1. 克隆本仓库：

   bash 复制代码

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

2. 创建包含Dify API密钥的.env文件：

   bash 复制代码

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

3. 在Cline中安装服务器：

   bash 复制代码

   fastmcp install notion_mcp_server.py

   这将自动执行以下操作：

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

使用方法

安装完成后，您可以通过在Cline中提问来使用该服务器查询Notion知识库。例如：

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

服务器将返回来自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. 安装依赖项：

   bash 复制代码

   pip install -r requirements.txt

2. 运行开发服务器：

   bash 复制代码

   fastmcp dev notion_mcp_server.py

这将启动MCP检查器界面用于测试服务器。

故障排除

1. 服务器连接失败

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

2. 依赖项问题

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

3. 服务器无响应

   • 确保按照配置说明使用uv运行命令
   • 检查服务器日志中的错误信息

贡献指南

请参阅mcp_instructions.md获取关于服务器实现和架构的详细信息。

许可证

MIT