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 許可證。