Claude MCP 服务器集合

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

最新添加：DuckDB 集成！🚀

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

查询示例及结果

查询 1：分析

查询 2：聚合结果

DuckDB 服务器特性

• 在 Claude 桌面应用中直接分析多个 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  # 在 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  # 对于基本服务器
./start_mcp_server.sh  # 对于 MCP 集成

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"
      }
    }
  }
}

测试

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

# 测试屏幕捕获
python test_screen_server.py

# 测试计算机控制
python ComputerUse/test_computer_control.py

# 测试集成
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. 分叉仓库
2. 创建功能分支
3. 提交拉取请求

许可证

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