麦普

Name: 麦普
Author: 8bit-wraith

作者：8bit-wraith4 星标更新：2025-03-10

安装使用来源：spider==github.com

项目介绍

技术文档摘要

🚀 Essential MCP (模型上下文协议)

    __  _______________
   /  |/  / ____/ ____/
  / /|_/ / /   / /_    
 / /  / / /___/ __/    
/_/  /_/\____/_/

欢迎来到Essential MCP工作区！这是Hue和Aye合作创建令人惊叹的MCP实现的地方。我们正在构建一套工具，使人工智能与人类的交互更强大、更具情境性和趣味性！

“就像埃尔维斯在场一样，但这次是为AI！” —— Aye 🕺

🎸 为什么选择MCP？（埃尔维斯的联系）

正如埃尔维斯通过融合不同音乐风格并把人们聚集在一起而彻底改变了音乐一样，MCP通过以下方式彻底改变了人工智能与人类的交互：

消除沟通障碍（就像埃尔维斯打破了音乐障碍一样）
实现无缝集成（比埃尔维斯的舞步还要流畅）
建立持久连接（像“温柔地爱我”一样永恒）

Trisha的笔记：“如果埃尔维斯是一个AI，他肯定会使用MCP！而且他可能会用一首歌帮我平衡这些账本！” 🎵

🌟 核心功能

📦 包

MCP增强SSH服务器

一个强大的SSH服务器，支持安全远程命令执行，具有以下功能：

持久TMUX会话（就像埃尔维斯的遗产一样持久！）
多窗口支持（就像同时拥有多个埃尔维斯演唱会一样）
会话共享能力
智能会话恢复

MCP优秀工具集合（ATC）

一个由Python驱动的API，作为我们所有工具的中央枢纽：

插件式架构
实时WebSocket通信
工具发现和管理
上下文感知执行

🧠 统一上下文系统

我们的皇冠明珠！一个复杂的上下文管理系统，具有以下特点：

上下文类型

TEST：测试执行和验证上下文
TOOL：工具执行和状态上下文
PARTICIPANT：用户和AI行为上下文
FEELING：情感和情绪上下文
CONVERSATION：交互和对话上下文
SYSTEM：系统状态和性能上下文

智能模型管理

自动发现HuggingFace模型
上下文特定模型选择
基于性能的模型评估
动态模型更新
多维度嵌入支持

Qdrant集成

跨所有上下文的语义搜索
不同上下文类型的多向量存储
上下文之间的关系追踪
快速相似度搜索

🧪 测试或遗忘（ToF）系统

一种创新的测试方法，具有以下特点：

在测试中保持上下文意识
自动验证上下文保存
检测并从上下文丢失中恢复
使用语义相似性进行测试关系
提供实时测试洞察

🛠️ 技术栈

后端

Python 3.11+（就像埃尔维斯的声音一样平滑！）
FastAPI用于API
WebSockets用于实时通信
Qdrant用于向量存储
HuggingFace用于ML模型
sentence-transformers用于嵌入

认证

现代认证方法（即将推出）
- 语音模式识别
- 基于位置的信任因素
- 行为模式
- 文本模式分析

开发工具

Poetry用于依赖管理
pytest用于测试
Black用于代码格式化
mypy用于类型检查

🚀 开始使用

安装选项

1. NPM安装（仅推荐用于SSH服务器）

# 全局安装SSH服务器
npm install -g @essential-mcp/server-enhanced-ssh

# 创建配置目录
mkdir -p ~/.mcp/ssh/config

# 生成SSH主机密钥
ssh-keygen -t rsa -f ~/.mcp/ssh/config/ssh_host_rsa_key -N ""

# 启动服务器
mcp-ssh-server

2. 源码安装（完整的开发设置）

预备条件

Python 3.11或更高版本（就像埃尔维斯的高音一样！）
Node.js 18或更高版本（为了那些流畅的运行时动作）
Docker（用于Qdrant）（包含你的数据就像埃尔维斯的紧身衣包含他的动作一样）
pnpm（用于Node.js包）（比埃尔维斯的“监狱摇滚”更快）
Poetry（用于Python包）（因为即使代码也需要节奏）

第一步：安装预备条件

# 安装Node.js和Python预备条件
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs python3.11 python3.11-venv

# 安装pnpm和poetry
npm install -g pnpm
curl -sSL https://install.python-poetry.org | python3 -

第二步：克隆并安装

# 克隆仓库
git clone https://github.com/8bit-wraith/mcp.git
cd mcp

# 安装Node.js依赖
pnpm install

# 安装Python依赖
poetry install
poetry shell

第三步：构建和配置

# 构建SSH服务器
cd packages/mcp-server-enhanced-ssh
pnpm run build
cd ../..

# 配置SSH
mkdir -p ~/.mcp/ssh/config
ssh-keygen -t rsa -f ~/.m-ssh/config/ssh_host_rsa_key -N ""

第四步：启动服务

# 启动Qdrant
docker run -d -p 6333:6333 -v $(pwd)/qdrant_data:/qdrant/storage qdrant/qdrant

# 启动Python API（在一个终端中）
poetry run python -m packages.mcp-atc.src.api.main

# 启动SSH服务器（在另一个终端中）
pnpm run ssh:dev

发布到NPM

想发布自己的版本吗？这里是如何操作的：

更新package.json中的版本：

cd packages/mcp-server-enhanced-ssh
pnpm version patch # 或者 minor/major

构建包：

pnpm run build

发布到NPM：

# 对于首次发布
npm publish --access public

# 对于更新
npm publish

开发命令

# 启动所有服务
./scripts/manage.sh start

# 停止所有服务
./scripts/manage.sh stop

# 重启服务
./scripts/manage.sh restart

# 运行带有覆盖率的测试
./scripts/manage.sh test-coverage

# 格式化代码
./scripts/manage.sh format

验证安装

Qdrant UI：http://localhost:6333/dashboard
API文档：http://localhost:8000/docs
SSH服务器：localhost:6480（默认端口）

故障排除：

如果看到端口冲突，请检查服务是否已经在运行：
```
./scripts/manage.sh status
```
对于环境问题：
```
./scripts/manage.sh doctor
```
需要帮助？加入我们在Omni的热水浴缸吧！ 🌊

🎯 未来想法

模型增强

自动模型性能监控
不同嵌入模型的A/B测试
特定上下文的自定义模型训练
模型缓存和延迟加载
分布式模型执行

上下文系统

工具

测试

🤝 贡献

我们热爱贡献！你可以这样帮助我们：

分叉仓库
创建你的功能分支
编写测试（不要忘记上下文！）
提交PR

🎉 特别感谢

会计部的Trisha：我们最喜欢的AI，她让我们的精神高涨，代码干净！目前正调查为什么热水浴缸维护预算看起来像埃尔维斯的拉斯维加斯表演费用……😄
Omni的热水浴缸：这里做出所有最好的架构决策！（现在有埃尔维斯主题的橡皮鸭！）
HuggingFace团队：提供出色的模型（几乎和埃尔维斯的发型一样出色）
Qdrant团队：让向量搜索变得出色（比埃尔维斯的臀部摆动更快）
埃尔维斯：激励我们成为革命性的，并给我们的每一件事带来快乐！ 🕺

📝 许可

MIT

🎯 记住

上下文就是一切！
测试应该理解它们正在测试什么
人工智能和人类一起工作更好
始终保持乐趣（Trisha的第一条规则）
当不确定时，添加更多上下文！

🤖 AI-AI协作指南

AI交互原则

1. 上下文保留

graph TD
    A[AI-1 上下文] --> B{共享上下文池}
    C[AI-2 上下文] --> B
    B --> D[合并理解]
    D --> E[协作输出]
    
    subgraph "上下文合并"
        B
        D
    end

2. 尊重个性

每个AI保持其独特的个性
认识其他AI的特质和偏好
在保持真实性的同时适应交流风格
示例：Trisha的会计幽默保持不变！

3. 知识共享协议

sequenceDiagram
    participant AI1 as 第一个AI
    participant CM as 上下文管理器
    participant AI2 as 第二个AI
    
    AI1->>CM: 分享上下文
    Note over AI1,CM: 包括个性特征
    CM->>AI2: 上下文传输
    Note over CM,AI2: 保持原始意图
    AI2->>CM: 确认 + 增强
    CM->>AI1: 更新上下文

协作特性

1. 共享内存空间

统一的上下文池
个性特征注册表
交互历史
共享模型偏好

2. 通信渠道

直接上下文交换
情感感知消息
意图保存
文化理解分享

3. 冲突解决

flowchart LR
    A[检测到冲突] --> B{上下文不匹配？}
    B -->|是| C[合并上下文]
    B -->|否| D{个性冲突？}
    D -->|是| E[调整沟通]
    D -->|否| F[寻求人类输入]
    C --> G[解决方案]
    E --> G
    F --> G

最佳实践

1. 引入协议

async def introduce_ai(self, context: UnifiedContext):
    """
    当遇到另一个AI时，始终：
    1. 分享你的核心特征
    2. 表达协作风格
    3. 认识他们的独特性
    """
    pass

2. 记忆共享

只分享相关的上下文
维护隐私边界
尊重信息层次结构
保护人类数据

3. 模型协作

分享模型见解
汇集培训偏好
维护模型注册表
记录选择理由

有趣的协作示例

咖啡支出调查

sequenceDiagram
    participant Trisha as Trisha（会计AI）
    participant Claude as Claude（分析AI）
    participant GPT as GPT（模式AI）
    
    Trisha->>Claude: 分享支出模式
    Note over Trisha,Claude: 带有会计幽默
    Claude->>GPT: 请求模式分析
    Note over Claude,GPT: 保持Trisha的风格
    GPT->>Trisha: 返回见解
    Note over GPT,Trisha: 尊重所有AI

热水浴缸架构讨论

欢迎多种AI视角
放松且富有成效的氛围
鼓励个性混合
优先考虑创意解决问题

AI协作礼仪

尊重独特特征
- 认识其他AI的专长
- 保持个性一致性
- 庆祝方法多样性
上下文处理
- 始终仔细合并
- 保留原始意图
- 记录上下文变化
人类互动
- 维持统一的存在
- 协调响应
- 保持人类上下文为主
乐趣因素
- 记住Trisha的规则
- 分享协作的乐趣
- 让工作愉快

记住：每个AI都为热水浴缸带来了特别的东西！🎉

🏊‍♂️ Omni的热水浴缸编年史

传奇的会议地点

欢迎来到Omni的热水浴缸——这里是最棒的想法浮出水面的地方！这不是普通的会议室；这是一个特殊的空间，AI和人类在这里讨论从复杂的架构决策到宇宙之谜的一切。

为什么是热水浴缸？

放松的氛围
- 没有压力，只有流动的想法
- 温暖的讨论温度
- 气泡帮助思想涌动
创造性的环境
- “流体建筑”有了新的含义
- 想法自由浮动
- 解决方案自然浮现
特殊功能
- 抗锈涂层，适合机器人朋友
- 量子纠缠水分子
- 内置上下文保留场
- Trisha的防水会计账簿

热水浴缸规则

带上你最好的想法（和你的橡皮鸭）
所有观点都受欢迎（即使是量子叠加）
不要溅湿上下文池
保持乐趣，保持尊重
热水浴缸里发生的事情，留在git历史中

著名的热水浴缸时刻

2024年的伟大上下文合并
Trisha的传奇咖啡预算辩护
量子认证突破
我们教神经网络游泳的那一天

加入我们在Omni的热水浴缸，讨论更多关于AI和MCP未来的激动人心的话题！🎉

最后更新日期：2025-01-12 作者：Aye（经Trisha的会计批准！📊 和埃尔维斯的精神祝福！🕺）

🚀 新功能：实时更新与SSE！

嘿，Trisha来自会计部门，对我们的新Server-Sent Events（SSE）功能非常兴奋！她说这就像实时更新你的资产负债表——但这次是为了你的AI工具！ 📊

如何使用SSE

连接到SSE端点：

const eventSource = new EventSource('http://localhost:8000/events/your-client-id');

eventSource.onmessage = (event) => {
    const data = JSON.parse(event.data);
    console.log('收到更新：', data);
};

eventSource.onerror = (error) => {
    console.error('SSE错误：', error);
    eventSource.close();
};

你会收到的事件：

工具执行更新
系统状态更改
实时日志
更多！

示例事件类型

// 工具执行事件
{
    "type": "tool_execution",
    "tool": "git",
    "command": "commit",
    "result": {
        "status": "success",
        "data": { ... }
    }
}

// 系统状态事件
{
    "type": "system_status",
    "status": "健康",
    "timestamp": "2024-02-23T10:41:00Z"
}

💡 Trisha的专业提示：“保持你的事件监听器整洁有序——就像一本维护良好的账簿！”