AI导哈

配置管理工具

claude-config-mcp是一个用于管理Claude Code配置的MCP工具，提供跨会话智能记忆系统和文件语义搜索功能。

  • by znlnzi
  • Go
  • 本地部署
  • 更新于
在 GitHub 查看 znlnzi/claude-config-studio

使用说明

克劳德配置mcp

英语 | 中文

Claude Code在会话之间会忘记一切。此MCP服务器修复了此问题。

📖 文档 | 📦 npm | 🗺️ 路线图

claude-config-mcp管理您的claude代码 .claude/ 通过MCP工具进行配置，并添加 luoshu (洛书) --一个跨会话智能记忆系统，让克劳德在对话中记住你的决定、偏好和项目背景。

建筑

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

特性

配置管理

管理克劳德代码 .claude/ 通过MCP工具创建目录：

  • 记忆 --读/写/搜索 .claude/memory/ 跨项目的文件
  • 配置 --获取/保存全局和项目级配置（CLAUDE.md、settings.json、.mcp.json）
  • 模板 --安装/卸载配置模板包（规则、代理、技能、命令）
  • 扩展 --代理、规则、技能和命令的CRUD操作
  • 钩子 --管理事件挂钩（PreToolUse、PostToolUse、SessionStart、Stop等）
  • 进化 --分析重复、差距和健康问题的规则

Luoshu (洛书) Intelligent Memory

由LLM和矢量搜索驱动的跨会话存储系统：

  • 自动提取 --从对话中自动提取关键决策、模式和上下文
  • 语义搜索 --使用向量相似性而不仅仅是关键字查找相关记忆
  • 智能召回 --问自然语言问题，比如“关于身份验证做出了什么决定？”，并得到综合答案
  • 优雅降级 --无需LLM配置即可工作（仅限关键字搜索），使用LLM解锁全部功能

安装

npm（推荐）

npm install -g claude-config-mcp

这将为您的平台安装二进制文件并注册 /luoshu.setup 和 /luoshu.config 技能。

然后注册MCP服务器：

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

来源

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

这将构建二进制文件，并将其安装到 ~/.local/bin/，将技能复制到 ~/.claude/skills/，并在克劳德代码中注册。

快速开始

安装后，重新启动Claude Code并键入：

/luoshu.setup

这将：

  1. 检测您的项目类型和技术栈
  2. 问3个关于你偏好的快速问题
  3. 安装匹配的配置模板
  4. 指导您完成智能内存的LLM设置（可选）

MCP工具

内存管理

工具 说明
save_memory 将内存条目保存到 .claude/memory/
load_memory 从项目加载内存文件
search_memory 自动语义补充的关键字搜索

配置

工具 说明
config_get_global 获取全局Claude代码配置
config_save_global 保存全局配置字段
config_save_project 保存项目级配置字段
get_project_config 获取项目的 .claude/ 目录概述
list_projects 列出所有管理项目

模板

工具 说明
template_list 列出可用的配置模板
template_install 将模板安装到项目或全局范围
template_uninstall 卸载模板
template_installed 列出已安装的模板

扩展

工具 说明
extension_list 列表扩展（代理/规则/技能/命令）
extension_read 读取扩展文件
extension_save 创建或更新扩展
extension_delete 删除扩展名

钩子

工具 说明
hooks_list 列出已配置的挂钩
hooks_save 保存挂钩配置

进化

工具 说明
evolve_status 获取进化系统状态
evolve_analyze 分析问题的规则
evolve_apply 批准或拒绝建议

洛树配置

工具 说明
luoshu_config_get 获取当前洛书配置（API密钥被屏蔽）
luoshu_config_set 设置带有密钥预验证的配置字段
luoshu_config_validate 测试LLM/嵌入连接
luoshu_provider_list 列出所有可用的LLM提供程序预设

罗曙记忆

工具 说明
memory_extract 从对话文本中提取关键点
memory_semantic_search 基于记忆的向量相似性搜索
luoshu_recall LLM综合智能召回

洛舒状态

工具 说明
luoshu_status 获取系统统计数据（内存计数、索引大小、缓存）
luoshu_reindex 重建向量索引

导入/导出

工具 说明
export_config 将配置导出为base64编码的ZIP
import_config 从base64编码的ZIP导入配置

MCP资源

通过MCP资源URI对配置文件进行只读访问：

URI 描述
claude://global/claude-md 全局CLAUDE.md指令
claude://global/memory/{filename} 全局内存文件
claude://project/{path}/memory/{filename} 项目内存文件

洛树配置

Luoshu在以下位置使用本地配置文件 ~/.luoshu/config.json.通过配置 /luoshu.config 或环境变量：

环境变量 描述
LUOSHU_LLM_API_KEY LLM服务API密钥
LUOSHU_LLM_MODEL LLM型号名称
LUOSHU_EMBEDDING_API_KEY 嵌入服务API密钥
LUOSHU_EMBEDDING_MODEL 嵌入模型名称

支持的LLM提供程序（与OpenAI兼容的API）：

提供者 预设名称
OpenAI openai
DeepSeek deepseek
登月计划（基米） moonshot
吉普（GLM） zhipu
硅流 siliconflow
Volcengine豆瓣 volcengine
自定义 custom

使用 luoshu_provider_list 查看所有预设或设置 llm.provider 对于任何预设名称，端点和模型默认值都是自动填充的。

运输方式

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

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

HTTP模式在以下位置公开了一个可流式传输的HTTP端点 /mcp.

支持的平台

平台 架构
macOS ARM64（苹果硅）
macOS x64（英特尔）
Linux x64
Linux ARM64
Windows x64

项目结构

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

主要部件是 转到MCP服务器 (cmd/mcp-server/)，通过npm分发，并为所有平台提供预构建的二进制文件。

python/openviking-mcp/ 是一个配套的Python MCP服务器，通过以下方式提供对Claude Code内存和规则文件的语义搜索 OpenViking.

发展

# 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

贡献

看 贡献.md 用于开发设置、代码风格和拉取请求指南。

许可证

麻省理工学院

相关 MCP