MCP Relay Mind Server

🚀 MCP 服务器

MCP 服务器是一个中间件服务器，它在 Cursor IDE 和 AI 模型之间架起了桥梁。其核心价值在于利用项目上下文对 AI 的响应进行验证，确保响应符合项目实际需求，提升开发效率与质量。

🚀 快速开始

克隆代码库

git clone [仓库地址]

安装依赖

npm install

配置环境变量

创建 .env 文件并基于提供的 .env.example 模板进行配置：

cp .env.example .env

然后编辑文件，添加您的双子星 API 密钥和其他配置选项。

构建项目

npm run build

启动服务器

启动生产环境服务器：

npm start

在开发环境中使用热重载功能：

npm run dev

✨ 主要特性

• 项目上下文管理：管理和维护项目的上下文信息。
• AI 响应验证：验证 AI 生成的响应是否符合项目要求。
• 与 Gemini API 集成：集成双子星 API，提供强大的 AI 能力。
• 实时上下文更新：实时更新和同步项目上下文信息。
• 全面日志系统：记录服务器运行状态及操作日志。
• 本地部署简便：提供简单易用的本地部署方案。

📦 安装指南

先决条件

• Node.js（推荐 v14+）
• npm 或 yarn 包管理器
• Google Cloud 账户（用于双子星 API 访问）
• 双子星 API 密钥
• Cursor IDE

本地部署

使用提供的部署脚本实现一键式本地部署：

./scripts/deploy-local.sh

此脚本将执行以下操作：

• 检查 .env 文件的存在性。
• 安装所有依赖项。
• 构建项目。
• 以生产模式启动服务器。

如需更详细的部署说明，请参考 USAGE.md。

💻 使用示例

基础用法

您可以通过以下 API 端点与 MCP 服务器进行交互：

• GET /api/health：健康检查端点。
• POST /api/context/initialize：初始化项目上下文。
• POST /api/context/refresh：刷新项目上下文。
• POST /api/validate：验证 AI 生成的响应。
• POST /api/cursor/validate：Cursor IDE 专属验证端点。

更多详细信息请参考 USAGE.md。

📚 详细文档

• USAGE.md：详细使用说明。
• MCP_SERVER_IMPLEMENTATION_PLAN.md：实施计划。
• MCP_SERVER_ARCHITECTURE.md：架构概述。

🔧 技术细节

项目结构

mcp-server/
├── src/
│   ├── api/
│   │   ├── controllers/
│   │   ├── middleware/
│   │   └── routes/
│   ├── config/
│   ├── context/
│   ├── models/
│   ├── services/
│   ├── types/
│   ├── utils/
│   └── index.ts
├── logs/           # 日志文件目录
├── scripts/        # 部署和工具脚本
├── docs/           # 文档
├── .env
├── .env.example
├── .gitignore
├── package.json
├── tsconfig.json
└── README.md

📄 许可证

本项目采用 ISC 许可证。