FindMCP Logo FindMCP.info
Notion Knowledge Base MCP Server

Notion Knowledge Base MCP Server

site icon
2025.01.09 0
Python知识库管理开发工具集成开发效率交流协作
Notion Knowledge Base MCP Server 是一个通过 Cline VSCode 扩展提供对 Notion 知识库访问的 MCP 服务器。它允许用户直接从 Cline 查询 Notion 知识库，获取详细的答案和相关的 Notion 页面引用。该服务器基于 FastMCP 构建，具有可靠的性能和全面的错误处理与日志记录功能。
View on GitHub

Overview

基本能力

产品定位

Notion Knowledge Base MCP Server 是一个中间件服务，旨在为开发者提供从 Cline VSCode 扩展中直接访问和查询 Notion 知识库的能力。

核心功能

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

适用场景

  • 开发者在 VSCode 中快速查询项目文档
  • 团队协作时快速获取知识库信息
  • 需要集成 Notion 知识库到开发工作流中的场景

工具列表

  • Cline VSCode 扩展：提供与 MCP 服务器的交互界面
  • FastMCP：作为服务器运行的基础框架
  • uv：Python 包管理器，用于依赖管理

常见问题解答

  1. 服务器无法连接
  2. 检查 .env 文件中的 API 密钥
  3. 确保 Cline 配置中的服务器路径是绝对路径

  4. 确认 uv 已安装并在 PATH 中

  5. 依赖问题

  6. 尝试使用 fastmcp install notion_mcp_server.py --force 重新安装

  7. 确认 uv 已正确安装

  8. 服务器挂起

  9. 确保使用配置中指定的 uv run 命令
  10. 检查服务器日志中的错误信息

使用教程

使用依赖

  • Python 3.10 或更高版本
  • uv 包管理器
  • Cline VSCode 扩展
  • Dify API 密钥

安装命令：

# 安装 uv
pip install uv

# 安装 Cline VSCode 扩展
code --install-extension saoudrizwan.claude-dev

安装教程

  1. 克隆仓库： bash git clone https://github.com/yourusername/notion-mcp-server.git cd notion-mcp-server

  2. 创建 .env 文件： bash echo "DIFY_API_BACKEND_KEY=your-api-key-here" > .env

  3. 安装服务器： bash fastmcp install notion_mcp_server.py

调试方式

  1. 安装开发依赖： bash pip install -r requirements.txt

  2. 运行开发服务器： bash fastmcp dev notion_mcp_server.py

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

许可证

该项目遵循 MIT 开源许可条款。