Claude Desktop Notion MCP Server

Claude Desktop Notion MCP Server

site icon
2025.03.20 0
TypeScript文件管理开发辅助内容生成开发效率
Claude Desktop Notion MCP Server 是一个基于文件系统的模型上下文协议(MCP)服务器实现,专为 Claude Desktop 设计。该服务器为 Claude 提供了文件系统操作能力,使其能够读取、写入和操作用户系统上的文件。
View on GitHub

Overview

基本能力

产品定位

Claude Desktop Notion MCP Server 是一个文件系统操作服务,为 Claude Desktop 提供文件读写和管理功能。

核心功能

  • 使用 glob 模式匹配列出文件
  • 读取文件内容
  • 写入文件内容
  • 通过差异输出编辑文件
  • 删除文件
  • 安全路径规范化,防止目录遍历攻击

适用场景

  • 需要 Claude Desktop 与本地文件系统交互的场景
  • 自动化文件管理任务
  • 开发过程中需要文件操作的辅助工具

工具列表

  • list_files: 列出匹配 glob 模式的文件
  • read_file: 读取文件内容
  • write_file: 将内容写入文件
  • edit_file: 编辑现有文件并显示差异
  • delete_file: 删除文件

常见问题解答

  • 安全问题:服务器实现了路径规范化和验证,确保操作仅限于指定的基目录,防止目录遍历攻击。

使用教程

使用依赖

  • 需要安装 Bun v1.2.5 或更高版本

安装教程

git clone https://github.com/yourusername/claude-desktop-mcp.git
cd claude-desktop-mcp
bun install

调试方式

配置 claude_desktop_config.json 文件:

{
  "mcpServers": {
    "notion": {
      "command": "~/.bun/bin/bun",
      "args": [
        "run",
        "<your path>/src/notion/index.ts",
        "your_notion_integration_key_here"
      ]
    }
  }
}

如果未提供基目录,将使用当前工作目录。

许可证

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