MCP服务器
一个中间件服务器,充当Cursor IDE和AI模型之间的桥梁,使用项目上下文和Gemini验证AI响应。
特性
- 项目上下文管理
- AI响应验证
- 与Gemini API集成
- 实时上下文更新
- 综合测井系统
- 易于本地部署
先决条件
- Node.js(建议使用v14+)
- npm或纱线
- 谷歌云账户(用于Gemini API访问)
- Gemini API密钥
- 光标IDE
入门指南
- 克隆存储库
- 安装依赖项:
npm install- 创建一个
.env根目录中的文件基于提供的.env.example:
cp .env.example .env然后编辑文件以添加Gemini API密钥和其他配置选项。
- 构建项目:
npm run build- 启动服务器:
npm start对于热重载开发:
npm run dev部署
本地部署
使用提供的部署脚本简化设置:
./scripts/deploy-local.sh此脚本将:
- 检查是否存在
.env文件 - 安装依赖项
- 构建项目
- 以生产模式启动服务器
有关更详细的部署说明,请参阅 用法.md.
API终点
GET /api/health-健康检查端点POST /api/context/initialize-初始化项目上下文POST /api/context/refresh-刷新项目上下文POST /api/validate-验证AI响应POST /api/cursor/validate-游标IDE特定的验证端点
有关API的详细文档,请参阅 用法.md.
项目结构
mcp-server/
├── src/
│ ├── api/
│ │ ├── controllers/
│ │ ├── middleware/
│ │ └── routes/
│ ├── config/
│ ├── context/
│ ├── models/
│ ├── services/
│ ├── types/
│ ├── utils/
│ └── index.ts
├── logs/ # Log files directory
├── scripts/ # Deployment and utility scripts
├── docs/ # Documentation
├── .env
├── .env.example
├── .gitignore
├── package.json
├── tsconfig.json
└── README.md文档
- 用法.md -详细的使用说明
- MCP_SERVER_IMPLEMENTATION_PLAN.md -实施计划
- MCP_SERVER_ARCHITECTURE.md -架构概述
许可证
国际协调委员会
