返回 MCP 目录
public公开dns本地运行

SubspaceDomain

一个macOS原生的MCP桥接服务器,用于不同AI客户端间的通信与工具路由

article

README

🚀 MCP 桥接服务器

MCP 桥接服务器是一款原生 macOS 桥接服务器,实现了模型上下文协议(MCP),能让不同 AI 客户端(如 Claude 和 Cline)进行通信,有效打破客户端间的通信壁垒。

🚀 快速开始

MCP 桥接服务器作为中介,使不同的 MCP 客户端能够互相通信。它提供以下功能:

  • 原生 macOS 集成:使用 launchd 服务和 Unix 域套接字
  • 客户端注册的持久性:支持重启后恢复
  • 无缝通信:实现不同 AI 客户端之间的交互
  • 工具路由:支持客户端间的工具调用

✨ 主要特性

该项目正在积极开发中。当前进展如下:

  • [x] 基础桥接服务器实现
  • [x] Unix 套接字传输层
  • [x] macOS 服务集成框架
  • [x] 稳健的连接处理和错误恢复
  • [x] 增强日志记录功能(便于调试)
  • [x] 完整的 LaunchAgent 配置
  • [x] 服务生命周期管理
  • [x] 客户端状态管理与持久化
  • [x] 服务重启恢复机制
  • [x] 客户端发现和注册协议
  • [x] Claude 和 Cline 的配置模板

🔧 技术细节

MCP 桥接服务器包含以下几个关键组件:

  1. BridgeServer:核心服务器实现,负责处理客户端连接和消息路由
  2. UnixSocketTransport:基于 Unix 域套接字的原生 macOS 传输层
  3. StateManager:管理客户端状态及持久化
  4. MacOSServiceManager:实现与 macOS launchd 服务的集成

📦 安装指南

即将推出。

💻 使用示例

即将推出。

📚 详细文档

开发

先决条件

  • Node.js 18+ 版本
  • TypeScript
  • macOS(用于原生功能)

构建

# 安装依赖项
npm install

# 构建项目
npm run build

# 启动服务器
npm start

测试

# 运行测试
npm test

🤝 贡献

欢迎贡献!请随时提交 Pull Request。

📄 许可证

MIT

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端