MCP 服务器

Notion Knowledge Base MCP Server

一个 MCP 服务器，连接到你的 Notion 知识库，允许你使用 Cline 扩展直接从 VSCode 查询和检索信息。

README

Notion 知识库 MCP 服务器

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

功能特性

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

前提条件

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

安装

克隆此仓库：

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

创建一个包含您的 Dify API 密钥的 .env 文件：

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

在 Cline 中安装服务器：
```
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"
      }
    }
  }
}

开发

对于开发和测试：

安装依赖项：
```
pip install -r requirements.txt
```
运行开发服务器：
```
fastmcp dev notion_mcp_server.py
```

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

故障排除

服务器未连接
- 验证 .env 文件中的 API 密钥
- 确保 Cline 配置中的服务器路径是绝对路径
- 检查 uv 是否已安装并在您的 PATH 中
依赖项问题
- 尝试使用 fastmcp install notion_mcp_server.py --force 重新安装
- 验证 uv 是否已正确安装
服务器挂起
- 确保您正在使用配置中指定的 uv run 命令
- 检查服务器日志中是否有错误