# MCP Server for Local

一个基于 MCP (Multi-Component Platform) 的本地代理服务器和客户端实现，提供多种 AI 工具调用能力。

## 功能特点

### 核心功能
- **天气查询**：实时获取全球任意位置的天气信息，支持温度、湿度、风速等详细数据
- **谷歌搜索**：智能检索互联网信息，支持多语言和高级搜索语法
- **摄像头控制**：支持拍照、视频流和微表情分析，可用于情绪识别
- **图片生成**：集成 ComfyUI，支持文本到图像的 AI 生成
- **智能对话**：基于 DashScope 的 AI 对话能力，支持上下文理解和多轮对话

### 技术特性
- 跨平台支持（Windows 和 Linux）
- 模块化设计，易于扩展新功能
- 完整的日志系统，便于调试和监控
- 支持自定义工具和 API 集成
- 高性能并发处理能力

## 环境配置

### 系统要求
- Python 3.8+
- Node.js (可选，用于运行 JavaScript 服务器)
- Chrome 浏览器（用于谷歌搜索功能）
- 摄像头（用于拍照功能）
- 至少 4GB 内存
- 支持 CUDA 的显卡（可选，用于加速 AI 计算）

### 安装步骤

1. 克隆仓库：
```bash
git clone https://github.com/yourusername/mcp-server-for-local.git
cd mcp-server-for-local
```

2. 创建并激活虚拟环境：
```bash
# Windows
python -m venv .venv
.venv\Scripts\activate

# Linux
python3 -m venv .venv
source .venv/bin/activate
```

3. 安装依赖：
```bash
# 使用 uv 安装依赖
uv pip install -r requirements.txt

# 如果遇到网络问题，可以使用国内镜像
uv pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
```

4. 配置环境变量：
```bash
# 复制环境变量模板
cp .env.example .env

# 编辑 .env 文件，设置你的配置
```

### 环境变量配置
编辑 `.env` 文件，设置以下配置：

- `DASHSCOPE_API_KEY`: DashScope API 密钥（必填）
- `MODEL`: 使用的模型名称（默认：qwen-max）
- `CONFIG_FILE`: 服务器配置文件路径
- `GAODE_API_KEY`: 高德地图 API 密钥（用于天气查询）
- `CHROME_PATH`: Chrome 浏览器路径
- `CHROMEDRIVER_PATH`: ChromeDriver 路径
- `BASE_URL`: ComfyUI 服务器地址
- `SERVERS_DIR`: 服务器脚本目录
- `LOG_LEVEL`: 日志级别（可选：DEBUG, INFO, WARNING, ERROR）

## 使用方法

### 基本使用

1. 进入项目目录：
```bash
cd src/mcp
```

2. 运行客户端：
```bash
uv run .\client\mcp_client.py .\proxy\proxy_server.py
```

3. 在客户端中输入命令，例如：
- "北京的天气怎么样？"
- "在谷歌上搜索 Python 教程"
- "拍照"
- "生成一张猫的图片"

### 高级功能

1. **自定义工具**：
   - 在 `src/mcp/tools` 目录下添加新的工具类
   - 实现必要的接口方法
   - 在配置文件中注册新工具

2. **API 扩展**：
   - 支持添加新的 API 服务
   - 可配置 API 密钥和端点
   - 支持自定义请求和响应处理

3. **日志管理**：
   - 支持多级别日志记录
   - 可配置日志输出位置
   - 支持日志轮转和归档

## 常见问题

### 安装问题

1. 依赖安装失败：
```bash
# 尝试清理缓存后重新安装
uv pip cache purge
uv pip install -r requirements.txt
```

2. 虚拟环境问题：
```bash
# 如果激活失败，尝试重新创建虚拟环境
rm -rf .venv
python -m venv .venv
```

### 运行问题

1. 权限问题：
```bash
# Linux
chmod +x src/mcp/proxy/proxy_server.py
chmod +x src/mcp/client/mcp_client.py
```

2. Chrome 相关问题：
- 确保 Chrome 和 ChromeDriver 版本匹配
- 检查 Chrome 路径是否正确
- 确保有足够的权限运行 Chrome
- 如果遇到驱动问题，可以手动下载对应版本的 ChromeDriver

3. API 密钥问题：
- 检查 `.env` 文件中的 API 密钥是否正确
- 确保 API 密钥有足够的配额
- 检查网络连接是否正常

## 开发指南

### 项目结构
```
src/mcp/
├── client/          # 客户端代码
├── proxy/           # 代理服务器代码
├── tools/           # 工具实现
├── utils/           # 工具函数
└── config/          # 配置文件
```

### 添加新功能
1. 在 `tools` 目录下创建新的工具类
2. 实现必要的接口方法
3. 在配置文件中注册新工具
4. 编写测试用例
5. 更新文档

## 贡献指南

欢迎提交 Issue 和 Pull Request！在提交之前，请确保：
1. 代码符合项目规范
2. 添加了必要的测试
3. 更新了相关文档
4. 通过了所有测试

## 许可证

MIT License