Claude MCP Server Collection

Claude MCP 服务集合

此仓库包含一组模型上下文协议（MCP）服务，旨在增强 Claude 桌面应用的功能。每个服务都提供特定功能，让 Claude 能以不同方式与您的计算机交互。

最新新增：DuckDB 集成！🚀

新增用于高效大规模数据分析的 DuckDB FastAPI 服务：

查询和结果示例

查询 1：分析

查询 2：聚合结果

DuckDB 服务功能

• 直接在 Claude Desktop 中分析多个 CSV 文件（>1GB）
• 使用 DuckDB 执行闪电般快速的 SQL 查询
• 高效利用内存处理数据
• 连接池和缓存
• 自动清理未使用的连接

概述

本项目包含多个 MCP 服务：

1. 屏幕捕获服务 - 捕获并处理屏幕截图
2. 计算机控制服务 - 支持键盘和鼠标自动化
3. FastAPI 集成服务 - 处理数据并提供 API 端点
4. Curl 服务 - 提供 HTTP 请求功能
5. DuckDB 服务 - 支持大规模数据分析

先决条件

• Python 3.8 或更高版本
• Node.js 和 npm（用于文件系统服务）
• Claude 桌面应用
• Git

安装

1. 克隆仓库：

git clone https://github.com/syedazharmbnr1/ClaudeMCPServer.git
cd ClaudeMCPServer

2. 创建并激活虚拟环境：

python3 -m venv .env
source .env/bin/activate  # On Windows: .env\Scripts\activate

3. 安装依赖项：

pip install -r requirements.txt

服务组件

1. DuckDB 服务

支持 Claude 高效分析大型 CSV 文件。

设置和使用：

cd fastapi/duckdb
python main.py

功能：

• 同时处理多个 CSV 文件
• 处理大于 1GB 的文件
• 使用 DuckDB 快速执行 SQL 查询
• 高效利用内存进行处理
• 连接池

2. 屏幕捕获服务

支持 Claude 捕获并处理屏幕截图。

设置和使用：

python mcp_screen_server.py

功能：

• 实时屏幕捕获
• 动态图像压缩
• 支持 WebP 格式以优化文件大小
• 可自定义保存位置

3. 计算机控制服务

允许 Claude 控制鼠标和键盘操作。

设置和使用：

python ComputerUse/mcp_computer_server.py

功能：

• 鼠标移动和点击
• 键盘快捷键和文本输入
• 屏幕位置跟踪
• 剪贴板操作

4. FastAPI 集成服务

FastAPI 服务提供强大的 API 接口，用于数据处理和集成。

设置和配置：

1. 进入 FastAPI 目录：

cd fastapi

2. 配置环境变量：

export PYTHONPATH=/path/to/mcp-server-py
export PORT=8000

3. 启动服务：

python main.py

5. Curl 服务

为 Claude 提供 HTTP 请求功能。

设置：

cd Curl_Server
./start_server.sh  # For the basic server
./start_mcp_server.sh  # For the MCP integration

Claude 桌面应用集成

配置

1. 将 claude_desktop_config.json 复制到 Claude 桌面应用的配置目录

2. 更新配置中的路径，使其与您的系统相符：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "<your-paths-here>"
      ]
    },
    "duckdb": {
      "command": "/path/to/python",
      "args": [
        "/path/to/fastapi/duckdb/main.py"
      ],
      "cwd": "/path/to/fastapi/duckdb",
      "env": {
        "PYTHONPATH": "/path/to/mcp-server-py",
        "PORT": "8010"
      }
    }
  }
}

测试

每个组件都有自己的测试套件：

# Test screen capture
python test_screen_server.py

# Test computer control
python ComputerUse/test_computer_control.py

# Test integration
python ComputerUse/test_client.py

故障排除

常见问题

1. Python 路径问题：

• 确保正确设置 PYTHONPATH
• 确认虚拟环境已激活

2. 权限错误：

• 确保脚本文件具有可执行权限：

chmod +x *.py
chmod +x Curl_Server/*.sh

3. 端口冲突：

• 屏幕服务：默认端口 8767
• FastAPI 服务：默认端口 8000
• DuckDB 服务：默认端口 8010
• 集成服务：默认端口 8768

日志记录

• 查看 debug.log 获取详细错误消息
• 每个服务组件都会写入自己的日志文件

安全说明

1. GitHub 集成：

• 安全存储您的 GitHub 令牌
• 切勿将令牌提交到仓库

2. 文件系统访问：

• 谨慎配置文件系统路径
• 仅允许访问必要的目录

贡献

1. Fork 此仓库
2. 创建功能分支
3. 提交拉取请求

许可证

本项目采用 MIT 许可证授权——详情请参阅 LICENSE 文件。