Back to MCP directory
publicPublicdnsLocal runtime

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

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client