MCP Server (Model Context Protocol)

基本能力

产品定位

MCP Server 是一个上下文管理服务器，主要用于维护和管理上下文信息，支持与 GitHub Copilot 等工具的集成。

核心功能

1. 实时通信：通过 SSE (Server-Sent Events) 实现实时更新。
2. 数据持久化：使用 SQLite 存储上下文数据。
3. API 支持：提供 REST 和 JSON-RPC 2.0 格式的 API。
4. 批量操作：支持批量保存、更新和删除上下文。
5. 健康检查：提供 /health 端点用于检查服务器状态。

适用场景

1. 开发工具集成：如 GitHub Copilot，用于维护持久化的上下文。
2. 实时应用：需要实时更新和同步上下文信息的应用。
3. 数据管理：需要高效存储和检索上下文数据的场景。

工具列表

1. Docker：用于快速部署和运行 MCP Server。
2. Docker Compose：用于高级部署配置。
3. Unraid：支持通过 Unraid 应用商店安装。

常见问题解答

1. 数据存储路径：通过 DB_PATH 环境变量指定 SQLite 数据库路径。
2. 日志配置：通过 LOG_LEVEL 环境变量控制日志级别。
3. 健康检查：使用 /health 端点检查服务器状态。

使用教程

使用依赖

1. Docker：确保已安装 Docker。
2. Docker Compose（可选）：用于高级部署。

安装教程

Docker 安装

docker run -d --name mcp-server --restart unless-stopped -p 3000:3000 -v "$(pwd)/data":/app/data -e NODE_ENV=docker -e PORT=3000 -e DB_PATH=/app/data/context.db -e LOG_LEVEL=info --memory=512m --cpus=1 --health-cmd="wget -qO- http://localhost:3000/health || exit 1" --health-interval=30s --health-timeout=10s --health-retries=3 --health-start-period=10s --log-driver json-file --log-opt max-size=10m --log-opt max-file=3 maf38/mcp-server:2.0.0

Docker Compose 安装

version: '3'

services:
  mcp-server:
    image: maf38/mcp-server:2.0.0
    container_name: mcp-server
    restart: unless-stopped
    ports:
      - "3000:3000"
    volumes:
      - /path/to/data:/app/data
    environment:
      NODE_ENV: docker
      PORT: 3000
      DB_PATH: /app/data/context.db
      LOG_LEVEL: info
    deploy:
      resources:
        limits:
          memory: 512M
          cpus: '1.0'

调试方式

1. 检查日志：

docker logs mcp-server

1. 健康检查：

curl http://localhost:3000/health

1. 获取服务器能力：

curl http://localhost:3000/capabilities

许可证

该项目遵循 None 开源许可条款。