README.md•6.31 kB
# Kerry MCP Tools Collection
这是一个为Cursor设计的MCP (Model Context Protocol) 工具集合(自用,interview介绍)，提供多种实用功能，包括系统信息查询、个人档案管理、网络搜索和天气查询等。
## 🚀 功能特性
### 🔧 系统信息工具 (Host Info)
- 获取系统信息（操作系统、版本、架构）
- 获取CPU信息（处理器型号、核心数）
- 获取内存信息（总内存、已用内存、使用率）
- 获取磁盘信息（总容量、已用空间、使用率）
### 👤 个人档案工具 (Profile)
- 获取完整用户档案信息
- 简历摘要和专业成就
- 按类别查询技能列表
- 项目详细信息查询
- 动态更新用户兴趣
### 🌐 网络搜索工具 (Web Search)
- 实时网络搜索功能
- 新闻文章搜索
- 基于DuckDuckGo API
- 支持多语言搜索
### 🌤️ 天气查询工具 (Weather)
- 实时天气信息查询
- 多天天气预报
- 支持全球城市查询
- 基于OpenWeatherMap API
## 系统要求
- Python 3.8+
- Windows 10/11 (已测试)
- macOS (理论上支持)
- Linux (理论上支持)
## 📦 安装步骤
### 1. 克隆或下载项目
```bash
git clone https://github.com/Formyselfonly/mcp-demo.git
cd mcp-demo
```
### 2. 安装依赖
```bash
pip install -r requirements.txt
```
或者手动安装：
```bash
pip install mcp psutil requests
```
### 3. 测试MCP工具
```bash
# 测试所有工具
python test_tools.py
# 测试个人档案工具
python demo_profile.py
# 测试系统信息工具
python host_info_tools.py
```
应该看到类似这样的输出：
```json
🚀 开始测试所有MCP工具...
============================================================
🎯 演示用户档案功能
============================================================
📋 完整用户档案:
姓名: KerryZheng
职位: AI Engineer, LLM Engineer, AI Agent Engineer
位置: 深圳
GitHub: https://github.com/Formyselfonly/resume
============================================================
📄 演示简历摘要功能
============================================================
摘要: AI研究生，专注于大模型和人工智能体研究
主要成就:
✅ 发表SCI论文：MemoryRepository for AI NPC
✅ 2年实习经验，多个个人项目展示
✅ AI中台开发经验丰富
✅ Prompt工程专家，多领域应用
```
## 🎯 在Cursor中使用
### 方法1：通过Cursor设置界面（推荐）
1. 打开Cursor
2. 按 `Ctrl+,` 打开设置
3. 搜索 "MCP" 或 "Model Context Protocol"
4. 添加新的MCP server，配置如下：
- **名称**: `kerry-mcp-tools`
- **命令**: `python`
- **参数**: `["demo_main.py"]`
- **工作目录**: `D:\githubproject\mcp-demo` (或你的实际路径)
- **环境变量**:
- `PYTHONPATH`: `D:\githubproject\mcp-demo`
### 方法2：通过配置文件
在Cursor的设置中添加以下配置：
```json
{
"mcpServers": {
"kerry-mcp-tools": {
"command": "python",
"args": ["demo_main.py"],
"cwd": "D:\\githubproject\\mcp-demo",
"env": {
"PYTHONPATH": "D:\\githubproject\\mcp-demo"
}
}
}
}
```
## 🚀 启动MCP Server
### 方法1：直接运行（推荐）
```bash
python demo_main.py
```
### 方法2：测试工具
```bash
# 测试所有工具
python test_tools.py
# 测试个人档案
python demo_profile.py
```
## 💡 使用方法
### 启动MCP服务器
1. 运行 `python demo_main.py` 启动MCP服务器
2. 在Cursor中，MCP服务器应该自动连接
3. 现在你可以在对话中使用各种工具
### 可用工具列表
#### 🔧 系统信息工具
- `get_host_info` - 获取系统硬件和性能信息
#### 👤 个人档案工具
- `get_user_profile` - 获取完整用户档案
- `get_resume_summary` - 获取简历摘要
- `get_skills_by_category` - 按类别查询技能
- `get_project_details` - 获取项目详情
- `update_user_interest` - 更新用户兴趣
#### 🌐 网络搜索工具
- `web_search` - 执行网络搜索
- `get_news` - 获取新闻文章
#### 🌤️ 天气查询工具
- `get_weather` - 查询当前天气
- `get_weather_forecast` - 获取天气预报
### 使用示例
在Cursor中询问：
- "我的个人档案是什么？"
- "我的技能有哪些？"
- "搜索Python编程教程"
- "北京今天天气怎么样？"
- "我的系统信息"
## 故障排除
### 常见问题
1. **MCP server无法启动**
- 检查Python是否正确安装
- 检查依赖包是否安装：`pip list | findstr mcp`
2. **Cursor无法连接MCP server**
- 确保MCP server正在运行
- 检查工作目录路径是否正确
- 检查环境变量设置
3. **权限问题**
- 在Windows上，可能需要以管理员身份运行PowerShell
- 检查文件路径权限
### 日志信息
MCP server会输出详细的日志信息，包括：
- 工具注册状态
- 服务器启动状态
- 连接信息
## 🔧 扩展功能
要添加新的工具，只需：
1. 在相应的工具文件中定义新函数（如 `get_name_profile.py`）
2. 在 `demo_main.py` 中使用 `mcp.add_tool()` 注册工具
3. 重启MCP服务器
### 项目结构
```
mcp-demo/
├── demo_main.py # MCP服务器主程序
├── host_info_tools.py # 系统信息工具
├── get_name_profile.py # 个人档案工具
├── web_search_tools.py # 网络搜索工具
├── weather_tools.py # 天气查询工具
├── config.py # 配置文件
├── test_tools.py # 测试脚本
├── demo_profile.py # 个人档案演示
├── requirements.txt # 依赖包
└── README.md # 说明文档
```
## 📄 许可证
MIT License
## 🤝 贡献
欢迎提交Issue和Pull Request！
## 🌟 关于作者
**KerryZheng** - AI Engineer, LLM Engineer, AI Agent Engineer
- **GitHub**: [Formyselfonly](https://github.com/Formyselfonly)
- **简历**: [AI Engineer Resume](https://github.com/Formyselfonly/resume)
- **专业领域**: 大模型研究、Prompt工程、AI平台开发
## 📚 相关链接
- [MCP协议文档](https://modelcontextprotocol.io/)
- [Cursor编辑器](https://cursor.sh/)
- [OpenWeatherMap API](https://openweathermap.org/api)
- [DuckDuckGo API](https://duckduckgo.com/api)