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. 克隆仓库：

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

3. 安装依赖：

4. 配置环境变量：

环境变量配置

编辑 .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. 进入项目目录：

2. 运行客户端：

3. 在客户端中输入命令，例如：

• "北京的天气怎么样？"

• "在谷歌上搜索 Python 教程"

• "拍照"

• "生成一张猫的图片"

高级功能

1. 自定义工具：

   • 在 src/mcp/tools 目录下添加新的工具类

   • 实现必要的接口方法

   • 在配置文件中注册新工具

2. API 扩展：

   • 支持添加新的 API 服务

   • 可配置 API 密钥和端点

   • 支持自定义请求和响应处理

3. 日志管理：

   • 支持多级别日志记录

   • 可配置日志输出位置

   • 支持日志轮转和归档

常见问题

安装问题

1. 依赖安装失败：

2. 虚拟环境问题：

运行问题

1. 权限问题：

2. Chrome 相关问题：

• 确保 Chrome 和 ChromeDriver 版本匹配

• 检查 Chrome 路径是否正确

• 确保有足够的权限运行 Chrome

• 如果遇到驱动问题，可以手动下载对应版本的 ChromeDriver

3. API 密钥问题：

• 检查 .env 文件中的 API 密钥是否正确

• 确保 API 密钥有足够的配额

• 检查网络连接是否正常

开发指南

项目结构

添加新功能

1. 在 tools 目录下创建新的工具类

2. 实现必要的接口方法

3. 在配置文件中注册新工具

4. 编写测试用例

5. 更新文档

贡献指南

欢迎提交 Issue 和 Pull Request！在提交之前，请确保：

1. 代码符合项目规范

2. 添加了必要的测试

3. 更新了相关文档

4. 通过了所有测试

许可证

MIT License