doobidoo/mcp-memory-service

通用MCP内存服务镜像文档

1. 镜像概述和主要用途

本镜像提供通用MCP（内存控制协议）内存服务，旨在简化内存数据管理流程，支持语义化数据检索与多客户端并发访问。通过容器化部署，可快速集成至各类应用架构，为需要高效内存数据处理的场景提供稳定可靠的服务支持。

2. 核心功能和特性

• 语义搜索：基于语义理解的检索机制，提升数据查询的准确性和相关性
• 多客户端支持：兼容多种客户端接入方式，满足异构系统集成需求
• 通用MCP架构：采用标准化内存控制协议，确保服务的灵活性与扩展性
• 高效内存管理：优化内存资源分配策略，提升数据读写吞吐量
• 轻量化部署：容器化设计减少环境依赖，简化安装与配置流程

3. 使用场景和适用范围

• 企业级内存数据服务：为业务系统提供低延迟内存数据存储与检索支持
• 语义化数据处理平台：适用于智能搜索、数据分析等需要语义理解的应用场景
• 多客户端接入系统：支持多团队、多应用并行访问，适配微服务与分布式架构
• 开发测试环境：快速构建独立内存服务实例，加速应用开发与测试迭代

4. 使用方法和配置说明

4.1 基本部署（docker run）

bash
docker run -d \
  --name mcp-memory-service \
  -p 8080:8080 \
  -v ./data:/app/data \
  -e MCP_PORT=8080 \
  -e LOG_LEVEL=info \
  universal-mcp-memory-service:latest

4.2 Docker Compose配置示例

yaml
version: '3'
services:
  mcp-memory-service:
    image: universal-mcp-memory-service:latest
    container_name: mcp-memory-service
    ports:
      - "8080:8080"
    volumes:
      - ./data:/app/data  # 数据持久化目录
    environment:
      - MCP_PORT=8080               # 服务监听端口
      - LOG_LEVEL=info              # 日志级别（debug/info/warn/error）
      - SEMANTIC_SEARCH_ENABLED=true  # 是否启用语义搜索
      - CLIENT_MAX_CONCURRENT=100   # 最大并发客户端连接数
    restart: unless-stopped

5. 配置参数说明

5.1 核心环境变量

5.2 客户端接入

服务启动后，可通过HTTP/REST API或MCP协议接入，接口文档可访问 http://<服务IP>:<MCP_PORT>/docs 查看。