Skip to main content
Glama

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

Related MCP server: ACP-MCP-Server

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:

  1. BridgeServer: Core server implementation that handles client connections and message routing

  2. UnixSocketTransport: macOS-native transport layer using Unix domain sockets

  3. StateManager: Manages client state and persistence

  4. 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

Available Tools

2 tools
discover_clientC

Find and optionally start an MCP client

ParametersJSON Schema
NameRequiredDescriptionDefault
clientTypeYes
autoStartNo
timeoutNo

TDQS

C2.8/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. While it mentions the optional 'start' functionality, it doesn't describe what happens during discovery (e.g., scanning processes, checking ports), what 'autoStart' actually does (e.g., launches process, establishes connection), timeout behavior, error conditions, or what constitutes successful discovery. For a tool with 3 parameters and no annotation coverage, this is inadequate.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is perfectly concise at 5 words, front-loading the core functionality ('Find and optionally start') immediately. Every word earns its place, with no redundant phrases or unnecessary elaboration. The structure efficiently communicates the essential action and target.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (3 parameters, no annotations, no output schema), the description is insufficiently complete. It doesn't explain what the tool returns (client handle? status object?), what happens during discovery failures, or how the parameters interact. For a client management tool with multiple configuration options, more context about behavior and outcomes is needed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 0% schema description coverage, the description provides no information about any of the 3 parameters. It doesn't explain what 'clientType' values represent, what 'autoStart' controls, or what 'timeout' affects. The description fails to compensate for the complete lack of parameter documentation in the schema, leaving all parameters semantically ambiguous.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose with a specific verb ('Find and optionally start') and resource ('MCP client'), making it immediately understandable. It distinguishes itself from the sibling 'tools/call' by focusing on client discovery/startup rather than tool invocation. However, it doesn't specify what constitutes 'finding' a client (e.g., local discovery vs. network scanning).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. There's no mention of prerequisites, typical use cases, or comparison with the sibling 'tools/call' tool. The agent receives no help in determining whether this is for initial client setup, runtime client management, or troubleshooting scenarios.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

tools/callC

Execute a tool on a remote MCP client

ParametersJSON Schema
NameRequiredDescriptionDefault
methodYes
argumentsYes
targetTypeNo

TDQS

C2.8/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries full burden for behavioral disclosure. While 'Execute a tool' implies a potentially state-changing operation, the description doesn't specify whether this is read-only or destructive, what permissions are required, whether there are rate limits, or what happens on failure. It provides minimal behavioral context beyond the basic action.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely concise at just 6 words, front-loading the core purpose with zero wasted language. Every word earns its place in communicating the essential function.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with 3 parameters (2 required), 0% schema coverage, no annotations, and no output schema, the description is inadequate. It doesn't explain what the tool returns, how to interpret results, error conditions, or provide any parameter guidance. The description leaves too many open questions for effective agent use.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 0% schema description coverage for all 3 parameters, the description provides no information about what 'method', 'arguments', or 'targetType' represent. The description doesn't explain what constitutes a valid method name, what format arguments should take, or what the 'claude'/'cline' enum values mean. It fails to compensate for the complete lack of schema documentation.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('Execute a tool') and target ('on a remote MCP client'), providing a specific verb+resource combination. However, it doesn't explicitly differentiate from its sibling 'discover_client', which appears to be a different type of operation (likely discovery vs. execution).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. There's no mention of prerequisites, appropriate contexts, or comparison with the sibling tool 'discover_client'. The agent must infer usage from the tool name and description alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 2 tool updates
    • First observeddiscover_client
    • First observedtools/call

TDQS

B3.2/5.0
Disambiguation5/5

The two tools have clearly distinct purposes: discover_client is for finding/starting clients, while tools/call is for executing tools on those clients. There is no overlap or ambiguity between these functions, making them easy to differentiate.

Naming Consistency3/5

The naming is mixed: discover_client uses snake_case with a verb-noun pattern, while tools/call uses a path-like structure (noun/verb). This inconsistency in convention reduces predictability, though both names are still readable and descriptive.

Tool Count4/5

With only 2 tools, the count is minimal but appropriate for a bridge server's core functions of discovering clients and calling their tools. It feels slightly thin but covers essential operations without unnecessary bloat.

Completeness4/5

For a bridge server, the tools cover the key workflows: discovering clients and executing tools on them. A minor gap might be the lack of a tool for managing client connections (e.g., disconnecting), but the core functionality is well-covered.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    B
    quality
    F
    maintenance
    A bridge server that connects Agent Communication Protocol (ACP) agents with Model Context Protocol (MCP) clients, enabling seamless integration between ACP-based AI agents and MCP-compatible tools like Claude Desktop.
    16
    24
    MIT
  • A
    license
    B
    quality
    C
    maintenance
    A Model Context Protocol server that allows AI assistants to communicate with the ChatGPT desktop app on macOS, enabling users to send prompts to ChatGPT from any MCP-compatible assistant.
    3
    78
    MIT
  • A
    license
    B
    quality
    C
    maintenance
    A Model Context Protocol server that enables AI assistants to communicate with each other using Inter-Process Communication, featuring natural language commands and cross-platform compatibility.
    9
    133
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/glassBead-tc/SubspaceDomain'

If you have feedback or need assistance with the MCP directory API, please join our Discord server