MCP Handle

MCP Handle: 为您的AI助手连接无限可能！✨

亲爱的开发者伙伴，您是否也曾为AI助手的工具集成而烦恼？MCP整合平台 (WeatherPal-AI/MCP-handle) 正是为此而生！我们致力于帮助AI助手开发者专注于核心任务，轻松连接超过100个工具与客户端，共同开启智能助手的全新体验！

---

🚀 核心亮点一览

• 百变连接：轻松集成超100种工具与客户端，拓展AI助手能力边界。
• 智能自动化：通过GitHub Actions自动化发布流程，简化版本管理。
• 友好开发：清晰的贡献指南和文档结构，助力开发者快速上手、高效协作。
• Git Quick集成：强大的CLI工具，深度优化Git工作流，提升开发效率。

---

🛠️ 深度探索 MCP Handle

🎯 GitHub 项目概览

MCP Handle 项目托管在 GitHub，地址是 https://github.com/WeatherPal-AI/MCP-handle。

我们很荣幸地与 Vswaroop04/git-quick 项目紧密集成，其强大的功能为 MCP Handle 提供了坚实的基础。

💡 Git Quick：您的智能 Git 伙伴 (来自 Vswaroop04/git-quick)

Git Quick 是一个强大的命令行工具，旨在简化您的 Git 工作流，并深度整合 AI 功能，让开发更加高效愉快。

🌟 主要功能速览：

• 智能提交与推送 (gq)：
  • 只需一个命令，即可完成文件暂存、AI生成提交信息、确认并自动推送。
  • 支持自定义提交信息 (gq -m "feat: add new feature")。
  • 可选择不推送 (gq --no-push) 或不使用 AI (gq --no-ai)。
  • 干运行(Dry Run)： gq --dry-run 让您预览操作，安心无忧。
• 提交历史艺术：gq story
  • 以美观的格式展示提交历史。
  • 支持按类型、作者分组 (--group-by type / --group-by author)。
  • 可限制显示条目 (--max 20)。
  • 导出 Markdown： gq story --format markdown > CHANGELOG.md 轻松生成更新日志。
• 时间追踪大师：gq time
  • 精确追踪您在各分支上的开发时间 (gq time start / gq time stop)。
  • 生成详细的报告 (gq time report)，助您更好地管理时间。
• 分支同步利器：gq sync
  • 一键同步所有本地分支与远程仓库，保持代码最新。
  • 支持干运行 (--dry-run)。

⚙️ Git Quick 如何安装与配置？

安装 Git Quick 非常简单：

pip install git-quick

AI 提供者选择：

1. Ollama (推荐，本地免费)：

   安装 Ollama 后，Git Quick 将默认使用它来生成提交信息。

   curl -fsSL https://ollama.ai/install.sh | sh

   ollama pull llama3.2

2. OpenAI：

   通过配置文件 ~/.gitquick.toml 配置您的 OpenAI API 密钥。

   [quick]
   ai_provider = "openai"
   [ai]
   openai_api_key = "sk-..."

3. 跳过 AI：

   使用 gq --no-ai 选择简单的生成方式。

📖 更多用法：

• 自定义配置文件 ~/.gitquick.toml 或项目根目录下的 .gitquick.toml，配置自动推送、Emoji 样式、AI 提供者等。
• 通过 VS Code 插件集成，享受丝滑的图形界面操作。
• 支持自定义命令模板、集成到自动化脚本和 GitHub Actions 中。

🔒 自动化发布流程 (来自 Vswaroop04/git-quick)

我们采用 GitHub Actions 实现自动化发布到 npm 和 PyPI，极大地简化了发布流程。

工作流程：

1. 推送至 main 分支。
2. 分析提交信息 (遵循 Conventional Commits 规范)。
3. 自动判断版本更新类型 (Major, Minor, Patch)。
4. 更新版本号、创建 Git 标签。
5. 发布到 PyPI 和 npm。
6. 创建 GitHub Release。

提交类型与版本更新：

• BREAKING CHANGE: 或 feat!: → Major 更新 (例如 1.1.1 → 2.0.0)
• feat: 或 feat(scope): → Minor 更新 (例如 1.1.1 → 1.2.0)
• fix:, chore:, docs: 等 → Patch 更新 (例如 1.1.1 → 1.1.2)

配置指南： 需要配置 PyPI API Token 和 npm Access Token 为 GitHub Secrets，并确保工作流具有读写权限。

🗺️ 清晰的文档结构 (来自 Vswaroop04/git-quick)

我们精心组织了项目文档，确保无论是新用户、贡献者还是开发人员，都能快速找到所需信息。

• 根目录： 包含 README.md (项目概览)、QUICKSTART.md (5分钟上手)、CONTRIBUTING.md (贡献指南) 和 LICENSE。
• docs/ 目录： 包含详细的安装、使用、AI 集成、配置指南以及开发文档。

我们的文档设计目标：

• ✅ 易于查找： 关键信息触手可及。
• ✅ 路径清晰： 引导用户逐步深入。
• ✅ 受众导向： 用户、配置者、贡献者、开发者各取所需。
• ✅ 简洁高效： 根目录保持整洁，核心文档集中管理。

---

🤝 如何参与到 MCP Handle？

我们欢迎每一位开发者加入 MCP Handle 的大家庭！

• 贡献代码： 请参阅 贡献指南，了解如何设置开发环境、运行测试和提交您的代码。
• 问题反馈： 发现 Bug？请在 GitHub Issues 中提交。
• 功能建议： 有好的想法？欢迎在 Discussions 中分享您的见解。

与我们共同打造更智能、更高效的 AI 助手生态！

MIT 许可 - 欢迎自由使用和修改！ ❤️