AI导哈

数据查询服务器

一个用于增强Claude桌面应用功能的服务器集合，提供数据查询、屏幕捕捉、计算机控制等功能。

  • by syedazharmbnr1
  • Python
  • 本地部署
  • 27 星标
  • 更新于
在 GitHub 查看 syedazharmbnr1/ClaudeMCPServer

使用说明

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

  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设置正确
  • 验证虚拟环境是否已激活
  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许可证获得许可-有关详细信息，请参阅许可证文件。

相关 MCP