Harmony 2.0主代理-Gemini MCP服务器
一个强大的Gemini驱动的代理，作为Harmony 2.0开发的主指南，可通过Cursor的模型上下文协议（MCP）和其他MCP兼容工具访问。
🌟 特性
- 和谐2.0专家：对Harmony 2.0架构、模式和最佳实践有深入了解
- MCP集成：对Cursor和其他工具的完整模型上下文协议支持
- 免费版兼容：设计用于在免费层托管服务上运行
- 多个接口:
- 用于Cursor集成的MCP服务器 - 用于外部访问的REST API - 直接编程访问
📋 先决条件
- Node.js 18+
- Gemini API密钥（免费层可在 谷歌人工智能工作室)
🚀 快速开始
1.安装依赖项
npm install2.配置环境
复制 .env.example 到 .env 并添加您的Gemini API密钥：
cp .env.example .env编辑 .env:
GEMINI_API_KEY=your_gemini_api_key_here
PORT=30003.地方发展
运行REST API服务器：
npm startAPI将于 http://localhost:3000
运行MCP服务器（用于游标）：
npm run mcp🔧 光标集成
选项1：本地MCP服务器
- 添加到光标MCP配置中（通常在
~/.cursor/mcp.json或光标设置）：
{
"mcpServers": {
"harmony2-master": {
"command": "node",
"args": ["/absolute/path/to/harmony2-gemini-mcp/src/mcp-server.js"],
"env": {
"GEMINI_API_KEY": "your_gemini_api_key_here"
}
}
}
}- 重新启动游标
- Harmony 2.0工具将出现在Cursor的MCP工具部分
选项2：外部MCP服务器（建议共享）
部署服务器（请参阅部署部分）并配置Cursor以连接到它。
🌐 部署（免费层选项）
选项1:Vercel（推荐）
- 安装Vercel CLI：
npm i -g vercel- 部署：
vercel- 设置环境变量：
vercel env add GEMINI_API_KEY- 您的API将在
https://your-project.vercel.app
选项2：渲染
- 在上创建新的Web服务 渲染
- 连接您的GitHub存储库
- 使用这些设置：
- 构建命令： npm install - 启动命令： npm start
- 添加
GEMINI_API_KEY在环境变量中 - 部署！
方案3：铁路
- 在上创建新项目 铁路
- 连接您的GitHub存储库
- 添加
GEMINI_API_KEY环境变量 - 部署！
选项4:Fly.io
- 安装Fly CLI：
curl -L https://fly.io/install.sh | sh- 初始化：
fly launch- 设置秘密：
fly secrets set GEMINI_API_KEY=your_key_here- 部署：
fly deploy📡 API终点
健康检查
GET /health与Harmony Agent聊天
POST /api/chat
Body: {
"message": "How do I set up a new Harmony 2.0 project?",
"context": {} // optional
}分析代码
POST /api/analyze
Body: {
"code": "your code here",
"language": "javascript" // optional
}生成代码
POST /api/generate
Body: {
"description": "Create a React component for user authentication",
"componentType": "component" // optional
}获取指导
POST /api/guidance
Body: {
"topic": "state management"
}🛠️ MCP工具
MCP服务器公开了这些工具：
- harmony_chat -与Harmony 2.0主代理聊天
- harmony_analyze_code -分析代码是否符合Harmony 2.0标准
- harmony_generate_code -按照Harmony 2.0模式生成代码
- harmony_get-guide -获取有关Harmony 2.0主题的全面指导
📚 和谐2.0资源
🔐 安全说明
- 永远不要承诺你的
.env文件 - 确保Gemini API密钥的安全
- 对于生产环境，请使用托管平台提供的环境变量
- 考虑对公共API进行速率限制
🆓 免费等级限制
- API双子星：免费等级包括慷慨的使用限制
- 维塞尔：100GB带宽/月，无限制请求
- 渲染：750小时/月，512MB内存
- 铁路：$5免费信用/月
- Fly.io：3个共享虚拟机，3GB存储
🤝 贡献
欢迎投稿！请随时提交拉取请求。
📝 许可证
麻省理工学院
🆘 支持
对于问题或疑问：
- 检查 Harmony 2.0文档
- 在GitHub上打开一个问题
- 联系Harmony 2.0社区
______________________________________________________________________
内置❤️ 和谐2.0社区