MCP Bridge Server
A macOS-native bridge server for the Model Context Protocol (MCP) that enables communication between different AI clients like Claude and Cline.
Overview
The MCP Bridge Server acts as an intermediary between different MCP clients, allowing them to communicate with each other. It provides:
- macOS-native integration with launchd service and Unix domain sockets
- Persistent client registration across restarts
- Seamless communication between different AI clients
- Tool routing between clients
Project Status
This project is under active development. Current status:
- Basic bridge server implementation
- Unix socket transport layer
- macOS service integration framework
- Robust connection handling and error recovery
- Enhanced logging for debugging
- Complete LaunchAgent configuration
- Service lifecycle management
- Client persistence implementation
- Recovery mechanisms for service restarts
- Client discovery and registration protocol
- Configuration templates for Claude and Cline
Architecture
The MCP Bridge Server consists of several key components:
- BridgeServer: Core server implementation that handles client connections and message routing
- UnixSocketTransport: macOS-native transport layer using Unix domain sockets
- StateManager: Manages client state and persistence
- MacOSServiceManager: Handles integration with macOS launchd service
Installation
Coming soon
Usage
Coming soon
Development
Prerequisites
- Node.js 18+
- TypeScript
- macOS (for native features)
Building
# Install dependencies
npm install
# Build the project
npm run build
# Start the server
npm start
Testing
# Run tests
npm test
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
MIT