MCP Facade

by DmitryBe

212 downloads
Not rated
GitHub

About

MCP Facade is a facade service that provides a unified interface for managing and interacting with multiple MCP (Machine Conversation Protocol) servers. It acts as a single entry point for agents to communicate with various MCP servers while providing JWT-based authentication…

Details

Author
DmitryBe
Downloads
212
Categories
Other

- Unified access point for multiple MCP servers.
- Server management: register, update, and delete servers.
- Tool discovery and interaction across all servers.
- JWT-based authentication with fine-grained access control.
- Configurable access rules at the tool level (WILDCARD, SCOPE, USER_ID).
- PostgreSQL backend for server configurations and access rules.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP Facade
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Clone the repository, install dependencies with pnpm i, copy .env.example to .env, edit as needed, then run pnpm dev. Register MCP servers via the /api/mcp/servers endpoint and interact with tools through the /api/mcp endpoint. The server is also compatible with the oap-langgraph-tools-agent for use with LangGraph.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp facade": {
            "mcp-facade": {
                "command": "uv",
                "args": [
                    "sync"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-facade": {
        "command": "uv",
        "args": [
            "sync"
        ]
    }
}

MCP Facade

A powerful facade service that provides a unified interface for managing and interacting with multiple MCP (Machine Conversation Protocol) servers. It acts as a single entry point for agents to communicate with various MCP servers while providing robust authentication and access control.

Table of Contents

- Features
- Installation
- Configuration
- API Documentation
- Server Management
- Tool Management
- Access Control
- MCP Protocol
- Authentication
- Examples

Features

- Unified Access Point: Single interface for multiple MCP servers
- Server Management: Register, update, and manage multiple MCP servers
- Tool Management: Discover and interact with tools across all registered servers
- Authentication: JWT-based authentication with fine-grained access control
- Access Rules: Configurable access rules at the tool level
- Health Monitoring: Built-in health check endpoints
- Database Backend: PostgreSQL for storing server configurations and access rules

Run it locally

Run MCP servers (example)

Note: can skip this step if you have your mcp servers.

```bash
cd mcp-facade/mcp-servers

uv sync
source .venv/bin/activate
uv pip install -e .

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.