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. 克隆或下载项目
git clone https://github.com/Formyselfonly/mcp-demo.git
cd mcp-demo
2. 安装依赖
pip install -r requirements.txt
或者手动安装:
pip install mcp psutil requests
3. 测试MCP工具
# 测试所有工具
python test_tools.py
# 测试个人档案工具
python demo_profile.py
# 测试系统信息工具
python host_info_tools.py
应该看到类似这样的输出:
🚀 开始测试所有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设置界面(推荐)
- 打开Cursor
- 按
Ctrl+,打开设置 - 搜索 "MCP" 或 "Model Context Protocol"
- 添加新的MCP server,配置如下:
- 名称:
kerry-mcp-tools - 命令:
python - 参数:
["demo_main.py"] - 工作目录:
D:\githubproject\mcp-demo(或你的实际路径) - 环境变量:
PYTHONPATH:D:\githubproject\mcp-demo
- 名称:
方法2:通过配置文件
在Cursor的设置中添加以下配置:
{
"mcpServers": {
"kerry-mcp-tools": {
"command": "python",
"args": ["demo_main.py"],
"cwd": "D:\\githubproject\\mcp-demo",
"env": {
"PYTHONPATH": "D:\\githubproject\\mcp-demo"
}
}
}
}
🚀 启动MCP Server
方法1:直接运行(推荐)
python demo_main.py
方法2:测试工具
# 测试所有工具
python test_tools.py
# 测试个人档案
python demo_profile.py
💡 使用方法
启动MCP服务器
- 运行
python demo_main.py启动MCP服务器 - 在Cursor中,MCP服务器应该自动连接
- 现在你可以在对话中使用各种工具
可用工具列表
🔧 系统信息工具
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编程教程"
- "北京今天天气怎么样?"
- "我的系统信息"
故障排除
常见问题
-
MCP server无法启动
- 检查Python是否正确安装
- 检查依赖包是否安装:
pip list | findstr mcp
-
Cursor无法连接MCP server
- 确保MCP server正在运行
- 检查工作目录路径是否正确
- 检查环境变量设置
-
权限问题
- 在Windows上,可能需要以管理员身份运行PowerShell
- 检查文件路径权限
日志信息
MCP server会输出详细的日志信息,包括:
- 工具注册状态
- 服务器启动状态
- 连接信息
🔧 扩展功能
要添加新的工具,只需:
- 在相应的工具文件中定义新函数(如
get_name_profile.py) - 在
demo_main.py中使用mcp.add_tool()注册工具 - 重启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
- 简历: AI Engineer Resume
- 专业领域: 大模型研究、Prompt工程、AI平台开发
