克劳德配置mcp
  ](https://www.npmjs.com/package/claude-config-mcp) 
Claude Code在会话之间会忘记一切。此MCP服务器修复了此问题。
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
JSONL]
LU --> VecIdx[Vector Index
Embeddings]
LU --> Recall[Intelligent Recall
LLM Synthesis]
LU --> Provider[Multi-Provider
OpenAI Compatible]
OV --> ClaudeIdx[Claude Index
rules + memory files]
Provider --> OpenAI[OpenAI]
Provider --> DeepSeek[DeepSeek]
Provider --> More[Moonshot / Zhipu
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这将:
- 检测您的项目类型和技术栈
- 问3个关于你偏好的快速问题
- 安装匹配的配置模板
- 指导您完成智能内存的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:8080HTTP模式在以下位置公开了一个可流式传输的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 用于开发设置、代码风格和拉取请求指南。
许可证
麻省理工学院
