使用说明

项目简介

Claude Desktop Tools 是一个为 Anthropic 的 Claude 桌面应用设计的扩展工具集,它基于 Model Context Protocol (MCP) 协议,允许 Claude 与您的计算机进行更深入的交互。通过部署此项目提供的 MCP 服务器,您可以让 Claude 具备操作文件系统、控制浏览器、执行系统命令等高级能力,从而实现更强大的自动化和信息处理任务。

主要功能点

  • 屏幕截图与分析: 让 Claude 能够捕获桌面屏幕截图,并结合 Claude 的视觉能力进行分析。
  • 文件系统操作: 允许 Claude 访问和操作本地文件系统,例如列出目录、读取文件内容等。
  • 网页浏览器控制: 通过 Puppeteer 集成,使 Claude 能够控制网页浏览器,实现网页浏览、信息抓取等任务。
  • 系统命令执行: 赋予 Claude 执行系统命令的能力,以实现更底层的系统控制。
  • 桌面自动化: 支持模拟用户进行桌面操作,实现更广泛的自动化流程。
  • 持久化内存: 提供跨会话的持久化记忆功能,增强 Claude 的上下文理解能力。
  • Git 仓库管理: 集成 Git 功能,辅助 Claude 进行代码仓库管理。
  • SQLite 数据库操作: 支持 SQLite 数据库的创建和查询,扩展数据处理能力。
  • 序贯思维: 提供逐步推理能力,帮助 Claude 解决更复杂的问题。

安装步骤

  1. 克隆仓库

    git clone https://github.com/GrimFandango42/Claude-MCP-tools.git
    cd Claude-MCP-tools
  2. 安装 Python 依赖 (ClaudeDesktopAgent 和 ClaudeDesktopBridge)

    cd ClaudeDesktopAgent
    pip install -r requirements.txt
    cd ../ClaudeDesktopBridge
    pip install -r requirements.txt
    cd ..
  3. 安装 MCP 服务器包

    • 运行仓库根目录下的 'install-mcp-servers.bat' (Windows) 或参考 README 手动安装 Node.js 和 npm 包。

服务器配置

要将此 MCP 服务器与 Claude 客户端连接,您需要在 Claude 桌面应用的设置中配置 MCP 服务器的启动命令和参数。以下是一些常用服务器的配置示例,您需要根据实际使用的服务器进行配置。

截图服务器 (Screenshot Server)

  • 服务器启动命令 (command): 'python'
  • 服务器启动参数 (args): 'ClaudeDesktopAgent/simple_mcp_server.py'
  • Claude 客户端 MCP 服务器 URL 配置示例: 'ws://localhost:8090' (WebSocket) 或 'http://localhost:8090' (HTTP)

文件系统服务器 (Filesystem Server)

  • 服务器启动命令 (command): 'npx'
  • 服务器启动参数 (args): '@modelcontextprotocol/server-filesystem'
  • Claude 客户端 MCP 服务器 URL 配置示例: 'ws://localhost:8080'

Puppeteer 服务器 (Puppeteer Server)

  • 服务器启动命令 (command): 'npx'
  • 服务器启动参数 (args): '@modelcontextprotocol/server-puppeteer'
  • Claude 客户端 MCP 服务器 URL 配置示例: 'ws://localhost:8081'

内存服务器 (Memory Server)

  • 服务器启动命令 (command): 'npx'
  • 服务器启动参数 (args): '@modelcontextprotocol/server-memory'
  • Claude 客户端 MCP 服务器 URL 配置示例: 'ws://localhost:8082'

Git 服务器 (Git Server)

  • 服务器启动命令 (command): 'python'
  • 服务器启动参数 (args): 'ClaudeDesktopAgent/git_mcp_server.py'
  • Claude 客户端 MCP 服务器 URL 配置示例: 'ws://localhost:8092'

SQLite 服务器 (SQLite Server)

  • 服务器启动命令 (command): 'npx'
  • 服务器启动参数 (args): '@modelcontextprotocol/server-sqlite'
  • Claude 客户端 MCP 服务器 URL 配置示例: 'ws://localhost:8084'

序贯思考服务器 (Sequential Thinking Server)

  • 服务器启动命令 (command): 'npx'
  • 服务器启动参数 (args): '@modelcontextprotocol/server-sequential-thinking'
  • Claude 客户端 MCP 服务器 URL 配置示例: 'ws://localhost:8085'

注意:

  • 请确保已安装 Python 和 Node.js 环境。
  • 不同的服务器可能需要不同的运行环境和依赖,请参考仓库 README 的详细说明。
  • Claude 客户端需要配置对应服务器的 URL 地址才能连接并使用其功能。

基本使用方法

  1. 启动您需要的 MCP 服务器,例如截图服务器:
    cd ClaudeDesktopAgent
    python simple_mcp_server.py
  2. 在 Claude 桌面应用的设置中,添加 MCP 服务器 URL (例如 'ws://localhost:8090')。
  3. 在 Claude 中,您可以使用自然语言指令来调用 MCP 服务器提供的工具,例如:
    • "请截取我的桌面屏幕并描述你看到了什么?" (使用截图服务器)
    • "列出我当前目录下的所有 Python 文件。" (使用文件系统服务器)
    • "请使用浏览器访问 wikipedia.org 并搜索 '人工智能',然后总结第一段。" (使用 Puppeteer 服务器)

具体的使用场景和指令可以参考仓库 README 中的 Example Usage Scenarios 部分。

信息

分类

桌面与硬件