Contextbase

🚀 上下文基礎 (MCP 服務器)

上下文基礎是一個專為 AI 代理、助手和應用程序打造的模型上下文協議 (MCP) 服務器。它能夠高效地存儲、檢索和管理用戶的上下文信息，並且通過簡單的 API 來實現這些功能。

🚀 快速開始

上下文基礎服務器為 AI 相關應用提供了便捷的上下文信息管理方案。通過簡單的 API，你可以輕鬆地存儲、檢索和管理用戶的上下文信息。

✨ 主要特性

• 身份驗證系統：運用 JWT 和 bcrypt 技術，實現安全可靠的用戶認證。
• 記憶管理：提供專門的 API 端點，用於存儲和檢索記憶數據。
• 日誌系統：全面且細緻地記錄用戶的操作日誌。
• 現代技術棧：基於 TypeScript、Fastify、Prisma ORM 進行開發，保證系統的先進性和高效性。
• 數據庫集成：採用 PostgreSQL 數據庫，實現數據的持久化存儲。
• 緩存：藉助 Redis 實現高性能緩存，提升系統響應速度。

📦 安裝指南

先決條件

• Node.js (v14 或更高版本)
• PostgreSQL 數據庫
• Redis 服務器
• Docker 及 Docker Compose (可選，用於容器化部署)

安裝步驟

1. 克隆倉庫

   git clone https://github.com/imfeniljikadara/contextbase.git
   cd mcp
   

2. 安裝依賴項

   cd mcp-server
   npm install
   

3. 配置環境變量 在 mcp-server 目錄下創建一個 .env 文件，並添加以下變量：

   DATABASE_URL=postgresql://username:password@localhost:5432/mcp
   REDIS_HOST=localhost
   REDIS_PORT=6379
   JWT_SECRET=your_jwt_secret
   PORT=3000
   

4. 運行數據庫遷移

   npx prisma migrate dev
   

5. 啟動服務器

   npm start
   

   或者使用 Docker 啟動：

   docker-compose up
   

📚 詳細文檔

API 端點

身份驗證

• POST /api/auth/register - 註冊新用戶
• POST /api/auth/login - 登錄並獲取 JWT 訪問令牌

記憶

• GET /api/memory - 獲取所有記憶
• POST /api/memory - 創建新的記憶
• GET /api/memory/:id - 獲取特定記憶
• PUT /api/memory/:id - 更新記憶
• DELETE /api/memory/:id - 刪除記憶

日誌

• GET /api/logs - 獲取用戶操作日誌

開發信息

• 使用開發模式運行：

  npm run dev
  

• 執行測試：

  npm test
  

項目結構

mcp-server/
├── prisma/              # 數據庫架構和遷移文件
├── src/
│   ├── api/             # API 路由和控制器
│   ├── config/          # 配置文件
│   ├── db/              # 數據庫連接 (PostgreSQL, Redis)
│   ├── middleware/      # 自定義中間件
│   ├── models/          # 數據模型
│   ├── services/        # 業務邏輯
│   ├── utils/           # 工具函數
│   └── index.ts         # 應用程序入口點
├── scripts/             # 輔助腳本
├── .env                 # 環境變量文件
└── package.json         # 依賴項和腳本

📄 許可證

本項目採用 MIT 許可證。