claude-config-mcp

English | 中文

Claude Code forgets everything between sessions. This MCP server fixes that.

📖 Documentation | 📦 npm | 🗺️ Roadmap

claude-config-mcp manages your Claude Code .claude/ configuration through MCP tools, and adds luoshu (洛书) — a cross-session intelligent memory system that lets Claude remember your decisions, preferences, and project context across conversations.

Architecture

graph TB
    CC[Claude Code CLI] -->|MCP Protocol| MCP[claude-config-mcp Server]

    MCP --> CM[Configuration Management]
    MCP --> LU[Luoshu Memory Engine]
    MCP --> OV[File Semantic Search]

    CM --> Memory[Memory Tools]
    CM --> Config[Config Tools]
    CM --> Templates[Template Engine]
    CM --> Extensions[Extension Manager]
    CM --> Hooks[Hooks Manager]
    CM --> Evolution[Evolution Analyzer]

    LU --> Store[Memory Store<br/>JSONL]
    LU --> VecIdx[Vector Index<br/>Embeddings]
    LU --> Recall[Intelligent Recall<br/>LLM Synthesis]
    LU --> Provider[Multi-Provider<br/>OpenAI Compatible]

    OV --> ClaudeIdx[Claude Index<br/>rules + memory files]

    Provider --> OpenAI[OpenAI]
    Provider --> DeepSeek[DeepSeek]
    Provider --> More[Moonshot / Zhipu<br/>SiliconFlow / Volcengine]

    style MCP fill:#f9f,stroke:#333,stroke-width:2px
    style LU fill:#bbf,stroke:#333
    style CM fill:#bfb,stroke:#333

Related MCP server: Session Buddy

Features

Configuration Management

Manage Claude Code's .claude/ directory through MCP tools:

• Memory — Read/write/search .claude/memory/ files across projects

• Config — Get/save global and project-level configuration (CLAUDE.md, settings.json, .mcp.json)

• Templates — Install/uninstall configuration template packs (rules, agents, skills, commands)

• Extensions — CRUD operations for agents, rules, skills, and commands

• Hooks — Manage event hooks (PreToolUse, PostToolUse, SessionStart, Stop, etc.)

• Evolution — Analyze rules for duplicates, gaps, and health issues

Luoshu (洛书) Intelligent Memory

Cross-session memory system powered by LLM and vector search:

• Auto-extraction — Automatically extract key decisions, patterns, and context from conversations

• Semantic search — Find related memories using vector similarity, not just keywords

• Intelligent recall — Ask natural language questions like "what decisions were made about auth?" and get synthesized answers

• Graceful degradation — Works without LLM config (keyword search only), unlocks full power with LLM

Installation

npm (recommended)

npm install -g claude-config-mcp

This installs the binary for your platform and registers /luoshu.setup and /luoshu.config skills.

Then register the MCP server:

claude mcp add claude-config -s user -- npx -y claude-config-mcp

From source

git clone https://github.com/znlnzi/claude-config-studio.git
cd claude-config-studio
make install

This builds the binary, installs it to ~/.local/bin/, copies skills to ~/.claude/skills/, and registers with Claude Code.

Quick Start

After installation, restart Claude Code and type:

/luoshu.setup

This will:

1. Detect your project type and tech stack

2. Ask 3 quick questions about your preferences

3. Install matching configuration templates

4. Guide you through LLM setup for intelligent memory (optional)

MCP Tools

Memory Management

Configuration

Templates

Extensions

Hooks

Evolution

Luoshu Config

Luoshu Memory

Luoshu Status

Import/Export

MCP Resources

Read-only access to configuration files via MCP resource URIs:

Luoshu Configuration

Luoshu uses a local config file at ~/.luoshu/config.json. Configure via /luoshu.config or environment variables:

Supported LLM providers (OpenAI-compatible API):

Use luoshu_provider_list to see all presets, or set llm.provider to any preset name — endpoint and model defaults are auto-filled.

Transport Modes

# stdio (default, for Claude Code integration)
claude-config-mcp

# HTTP (for Docker, shared deployments)
claude-config-mcp --transport http --http-addr localhost:8080

HTTP mode exposes a Streamable HTTP endpoint at /mcp.

Supported Platforms

Project Structure

claude-config-studio/
├── cmd/mcp-server/       # MCP Server entry point (Go)
├── internal/
│   ├── luoshu/           # Luoshu memory engine (vector index, recall, config)
│   ├── templatedata/     # Built-in template definitions
│   └── evolution/        # Rules evolution engine
├── npm/                  # npm package distribution
├── dist/skills/          # Global skills (/luoshu.setup, /luoshu.config)
├── python/openviking-mcp/  # OpenViking semantic search MCP server (Python)
├── scripts/              # Build and publish scripts
└── Makefile              # Build, test, install targets

The main component is the Go MCP Server (cmd/mcp-server/), distributed via npm with pre-built binaries for all platforms.

python/openviking-mcp/ is a companion Python MCP server providing semantic search over Claude Code memory and rules files via OpenViking.

Development

# Build MCP server only
make mcp

# Run lint + build + tests
make test

# Run tests with verbose output
go test ./internal/... -v

# Cross-compile for all platforms
make npm-build

# Clean build artifacts
make clean

Contributing

See CONTRIBUTING.md for development setup, code style, and pull request guidelines.

License

MIT