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设置界面（推荐）

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的设置中添加以下配置：

{
  "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服务器

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
• 简历: AI Engineer Resume
• 专业领域: 大模型研究、Prompt工程、AI平台开发

📚 相关链接

• MCP协议文档
• Cursor编辑器
• OpenWeatherMap API
• DuckDuckGo API