内容
# MCP Bridge Server
一个 macOS 原生的桥接服务器,用于模型上下文协议(Model Context Protocol,MCP),使不同的 AI 客户端(如 Claude 和 Cline)之间能够进行通信。
## 概述
MCP Bridge Server 作为不同 MCP 客户端之间的中介,允许它们相互通信。它提供:
- **macOS 原生集成**,支持 launchd 服务和 Unix 域套接字
- **持久的客户端注册**,在重启后依然有效
- **无缝的通信**,支持不同 AI 客户端之间的交互
- **客户端之间的工具路由**
## 项目状态
该项目正在积极开发中。当前状态:
- [x] 基本的桥接服务器实现
- [x] Unix 套接字传输层
- [x] macOS 服务集成框架
- [x] 稳健的连接处理和错误恢复
- [x] 增强的调试日志记录
- [x] 完整的 LaunchAgent 配置
- [x] 服务生命周期管理
- [x] 客户端持久性实现
- [x] 服务重启的恢复机制
- [x] 客户端发现和注册协议
- [x] Claude 和 Cline 的配置模板
## 架构
MCP Bridge Server 由几个关键组件组成:
1. **BridgeServer**:核心服务器实现,处理客户端连接和消息路由
2. **UnixSocketTransport**:使用 Unix 域套接字的 macOS 原生传输层
3. **StateManager**:管理客户端状态和持久性
4. **MacOSServiceManager**:处理与 macOS launchd 服务的集成
## 安装
*即将推出*
## 使用
*即将推出*
## 开发
### 先决条件
- Node.js 18+
- TypeScript
- macOS(用于原生功能)
### 构建
```bash
# 安装依赖
npm install
# 构建项目
npm run build
# 启动服务器
npm start
```
### 测试
```bash
# 运行测试
npm test
```
## 贡献
欢迎贡献!请随时提交 Pull Request。
## 许可证
MIT