AI导哈

上下文管理配置系统

一个基于上下文的MCP服务器配置系统，用于Claude Desktop，支持在不同工作、个人、家庭和项目特定环境间无缝切换。

  • by jancel
  • Shell
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 jancel/mcp-context-manager

使用说明

MCP上下文管理器

Claude Desktop的基于上下文的MCP（模型上下文协议）服务器配置系统，实现了工作、个人、家庭和项目特定环境之间的无缝切换。

概述

该系统允许您为不同的环境（工作、个人、家庭、荣誉飞行等）维护单独的MCP服务器配置，同时在所有环境中共享公共服务。

特性

  • 🔄 上下文切换：在不同的MCP服务器配置之间快速切换
  • 🔗 共享服务：在所有上下文中都可用的通用MCP服务器（黑曜石、文件系统、shell、GitHub、Docker）
  • 🎯 特定于上下文的服务器：每个上下文都可以定义自己的专用MCP服务器
  • 🔒 环境管理：按上下文分离环境变量
  • 📦 简易安装：具有自动备份功能的简单设置脚本

快速开始

安装

  1. 克隆此存储库：
git clone https://github.com/YOUR-USERNAME/mcp-context-manager.git
cd mcp-context-manager
  1. 运行安装脚本：
./install.sh

这将：

  • 备份现有的Claude Desktop配置
  • 创建配置文件目录结构
  • 将上下文切换器安装到 ~/bin
  • 设置默认（个人）上下文
  1. 复制并配置您的环境文件：
cp profiles/work.env.example profiles/work.env
cp profiles/personal.env.example profiles/personal.env
cp profiles/family.env.example profiles/family.env
cp profiles/honorflight.env.example profiles/honorflight.env

# Edit each .env file with your actual paths and credentials

用法

使用切换上下文 claude-context 命令：

# Switch to work context
claude-context work

# Switch to Honor Flight context
claude-context honorflight

# Switch to personal context
claude-context personal

# Switch to family context
claude-context family

# Show current context
claude-context status

脚本将：

  1. 加载特定于上下文的环境变量
  2. 激活适当的MCP配置
  3. 重新启动克劳德桌面

目录结构

mcp-context-manager/
├── README.md
├── install.sh                          # Installation script
├── bin/
│   └── claude-context                  # Context switcher script
├── profiles/
│   ├── shared.json                     # Shared MCP servers
│   ├── work.json                       # Work context
│   ├── personal.json                   # Personal context
│   ├── family.json                     # Family context
│   ├── honorflight.json                # Honor Flight context
│   ├── work.env.example                # Environment template
│   ├── personal.env.example
│   ├── family.env.example
│   └── honorflight.env.example
└── docs/
    ├── adding-servers.md               # Guide for adding MCP servers
    └── contexts.md                     # Context descriptions

可用上下文

工作

基础设施工程、TechGrind开发、云运营

  • K8s集群管理
  • AWS运营
  • GitHub 仓库
  • Docker/Rancher桌面

个人

个人项目、家庭自动化、人工智能实验

  • 地方发展
  • 家庭基础设施
  • 个人笔记和计划

家庭

家庭日程安排、共享资源、家庭管理

  • 日历集成
  • 共享列表
  • 家庭自动化

荣誉飞行

大圣路易斯荣誉飞行运营和国家平台开发

  • 荣誉飞行数据库
  • 飞行管理系统
  • 应用处理
  • 通信系统

共享服务

以下MCP服务器可在 全部上下文:

  • 黑曜石：访问您的Obibrain保险库
  • 文件系统：本地文件操作
  • 外壳：终端/Zsh命令执行
  • GitHub：存储库访问和操作
  • 码头工人：容器管理（通过Rancher Desktop）

配置

添加新上下文

  1. 在中创建新的配置文件JSON文件 profiles/:
cp profiles/personal.json profiles/newcontext.json
  1. 创建环境文件：
cp profiles/personal.env.example profiles/newcontext.env

  1. 使用特定于上下文的服务器和变量编辑这两个文件

  2. 使用它：

claude-context newcontext

将MCP服务器添加到上下文中

在中编辑上下文的JSON文件 profiles/ 并添加您的服务器配置：

{
  "mcpServers": {
    "your-server": {
      "command": "node",
      "args": ["/path/to/your/mcp-server/index.js"],
      "env": {
        "API_KEY": "${YOUR_API_KEY}"
      }
    }
  }
}

看 docs/adding-servers.md 详细说明。

路线图

第1阶段（当前）

  • [x] 基于配置文件的配置系统
  • [x] 上下文切换脚本
  • [x] 核心共享服务（黑曜石、文件系统、shell、GitHub、Docker）
  • []完整的环境模板

第二阶段（下）

  • []荣耀飞行专用MCP服务器
  • []工作基础设施服务器（K8s、AWS、Terraform）
  • []自动凭证管理

第三阶段（未来）

  • []个人/家庭自动化服务器
  • []MCP服务器市场集成
  • []热插拔，无需重新启动
  • []基于Web的上下文仪表板

已知问题

  • Docker/Rancher桌面：目前使用标准的Docker MCP配置。在第二阶段，Rancher Desktop的套接字位置需要重新配置。
  • 上下文切换：需要重新启动Claude Desktop。正在研究热插拔功能。

贡献

这是一个公开供参考的个人配置系统。请随意分叉并适应您自己的使用！

许可证

MIT许可证-有关详细信息，请参阅许可证文件

作者

Jeff-云工程师，构建TechGrind PaaS和荣耀飞行国家平台

资源

相关 MCP