MCP 服务器

一个中间件服务器，作为 Cursor IDE 和 AI 模型之间的桥梁，并利用项目上下文验证 AI 的响应。

功能

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

先决条件

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

快速开始

1. 克隆代码库：

   git clone [仓库地址]
   

2. 安装依赖：

   npm install
   

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

   cp .env.example .env
   

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

4. 构建项目：

   npm run build
   

5. 启动服务器：

   npm start
   

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

   npm run dev
   

部署

本地部署

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

./scripts/deploy-local.sh

此脚本将执行以下操作：

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

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

API 端点

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

更多详细信息请参考 USAGE.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

文档

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

许可证

ISC