Claude MCP Server

Claude MCP服务器集合

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

最新添加：DuckDB集成！ 🚀

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

示例查询和结果

问题1：分析

DuckDB Query Example 1

查询2：汇总结果

DuckDB Query Example 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

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

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

1. 安装依赖项：

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

1. 配置环境变量：

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

1. 启动服务器：

python main.py

5.卷发器

为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 Desktop应用程序配置目录

1. 更新配置中的路径以匹配您的系统：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        ""
      ]
    },
    "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设置正确
• 验证虚拟环境是否已激活

1. 权限错误：

• 确保脚本文件可执行：

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

1. 端口冲突：

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

日志记录

• 检查 debug.log 有关详细的错误消息
• 每个服务器组件都会写入自己的日志文件

安全说明

1. GitHub集成：

• 安全地存储您的GitHub令牌
• 永远不要将令牌提交到存储库

1. 文件系统访问：

• 仔细配置文件系统路径
• 仅限制对必要目录的访问

贡献

1. 分叉存储库
2. 创建要素分支
3. 提交拉取请求

许可证

此项目根据MIT许可证获得许可-有关详细信息，请参阅许可证文件。