← Back to Skills Marketplace
jaggu1999

mcp-bridge

by jaggu1999 · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ✓ Security Clean
556
Downloads
0
Stars
7
Active Installs
2
Versions
Install in OpenClaw
/install mcp-bridge
Description
Use mcp-bridge-openclaw CLI to connect to and manage Model Context Protocol (MCP) servers with auto-reconnection and retry logic. Install via npm install -g...
README (SKILL.md)

mcp-bridge-openclaw

CLI tool for connecting to MCP servers with built-in resilience.

Installation

npm install -g mcp-bridge-openclaw

Verified publisher: npm user jaggu37

Commands

Connect to MCP server

mcp-bridge --config config.json

List available servers

mcp-bridge --config config.json --list

Run with verbose logging

mcp-bridge --verbose --config config.json

Configuration

Create config.json:

{
  "servers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"],
      "env": {}
    }
  }
}

Security tip: Use environment variables for tokens instead of plaintext in config:

{
  "servers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "${GITHUB_TOKEN}"
      }
    }
  }
}

Then run: GITHUB_TOKEN=your_token mcp-bridge --config config.json

Programmatic Usage

import { MCPBridge } from 'mcp-bridge-openclaw';

const bridge = new MCPBridge({
  configPath: './config.json',
  onServerConnect: (name) => console.log(`Connected to ${name}`),
});

await bridge.connect();
await bridge.disconnect();

Key Features

  • Auto-reconnect on disconnect
  • Configurable retry logic
  • Type-safe JSON config
  • CLI + programmatic API
  • Multiple server support
Usage Guidance
This skill appears to do what it says, but it executes and downloads code from npm (both during global install and via npx when launching server implementations). Before installing: 1) inspect the npm package and its GitHub repository (publisher, recent commits, issues). 2) Avoid global install if possible; consider installing in an isolated environment/container. 3) Pin versions and review package.json/maintainers. 4) Limit and scope any tokens (e.g., GITHUB_TOKEN) used by server implementations and do not store secrets in plaintext config files. 5) Review config.json to ensure the configured command/args are trusted (they can run arbitrary commands). If you need higher assurance, request the package source code or a reproducible build before use.
Capability Analysis
Type: OpenClaw Skill Name: mcp-bridge Version: 1.0.1 The skill bundle contains metadata and documentation for the 'mcp-bridge-openclaw' CLI tool, which is designed to manage Model Context Protocol (MCP) servers. The instructions in SKILL.md are consistent with the stated purpose, providing standard installation, configuration, and usage examples (including security best practices for environment variables) without any evidence of malicious intent, data exfiltration, or prompt injection.
Capability Assessment
Purpose & Capability
Name, description, and runtime instructions all describe a CLI/SDK for connecting to MCP servers. The npm package + config-based server definitions (including running server implementations via npx) are coherent with the stated purpose.
Instruction Scope
SKILL.md instructs installing the npm package and running the CLI with a config.json. The config lets you specify arbitrary commands/args (e.g., npx calls) and environment variables, which is expected for a bridge but means the skill's runtime can execute arbitrary third‑party code and read the provided config file and any env vars you pass.
Install Mechanism
There is no formal install spec in the skill bundle (it's instruction‑only), but SKILL.md tells users to run npm install -g. Installing a global npm package and using npx to fetch server implementations at runtime is typical here but increases supply‑chain risk because code is fetched from npm/GitHub during install or execution.
Credentials
The manifest declares no required env vars. SKILL.md recommends using environment variables for tokens (example: GITHUB_TOKEN). That is reasonable, but tokens grant access to external services and should be scoped and protected; the skill does not request unrelated credentials.
Persistence & Privilege
always is false and the skill is user-invocable. The skill does not request elevated platform privileges in the manifest. No indication it modifies other skills or system-wide settings.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install mcp-bridge
  3. After installation, invoke the skill by name or use /mcp-bridge
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
- Added homepage and repository links to SKILL.md for improved discoverability. - Noted verified npm publisher (`jaggu37`) in the documentation. - Updated config example to emphasize security best practices using environment variables for tokens. - Simplified configuration and usage examples for clarity. - Minor edits for improved documentation and security guidance.
v1.0.0
Initial release of mcp-bridge. - Provides CLI and programmatic tools to connect and manage Model Context Protocol (MCP) servers. - Supports auto-reconnection and configurable retry logic. - Manages multiple servers through a JSON config file. - Easy installation via npm. - Includes verbose logging and server listing options.
Metadata
Slug mcp-bridge
Version 1.0.1
License MIT-0
All-time Installs 7
Active Installs 7
Total Versions 2
Frequently Asked Questions

What is mcp-bridge?

Use mcp-bridge-openclaw CLI to connect to and manage Model Context Protocol (MCP) servers with auto-reconnection and retry logic. Install via npm install -g... It is an AI Agent Skill for Claude Code / OpenClaw, with 556 downloads so far.

How do I install mcp-bridge?

Run "/install mcp-bridge" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is mcp-bridge free?

Yes, mcp-bridge is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does mcp-bridge support?

mcp-bridge is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created mcp-bridge?

It is built and maintained by jaggu1999 (@jaggu1999); the current version is v1.0.1.

💬 Comments