AI导哈

Notion知识库查询服务

一个通过Cline VSCode扩展提供Notion知识库查询服务的MCP服务器，支持直接查询Notion知识库并获取详细答案和相关页面引用。

  • by rickydata-indexer
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 rickydata-indexer/notion_mcp_server

使用说明

概念知识库MCP服务器

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

特性

  • 直接从Cline查询您的Notion知识库
  • 通过参考Notion页面获得详细答案
  • 内置FastMCP，性能可靠
  • 全面的错误处理和记录

先决条件

安装

  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

用法

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

Tell me about internal tooling

服务器将回复您的Notion知识库中的相关信息，包括：

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

配置

服务器在安装过程中会自动配置，但如果需要，您可以手动更新Cline配置文件中的设置：

  • macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
  • 窗户： %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检查器界面以测试服务器。

故障排除

  1. 服务器未连接

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

  2. 依赖关系问题

    • 尝试使用重新安装 fastmcp install notion_mcp_server.py --force
    • 验证紫外线是否正确安装

  3. 服务器挂起

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

贡献

看 mcp指令.md 有关服务器实现和体系结构的详细信息。

许可证

麻省理工学院

相关 MCP