MCP Gateway

Local MCP Gateway

[English](./README.md) | [中文](./README.zh.md)

Local MCP Gateway is a local gateway for MCP clients.

It exposes local capabilities as standard MCP SSE and Streamable HTTP endpoints, so other MCP clients can call them through one gateway. Upstream, the gateway can connect to normal stdio MCP servers, custom Skills, bundled tools, and desktop/browser automation tools.

In practice, it turns a local machine into a controllable MCP tool hub: clients can call tools to read files, edit files, run commands, operate a browser, or use your own Skill workflows while keeping configuration, auth, path guards, and approvals in one UI.

What It Does

• Exposes MCP services over SSE and Streamable HTTP
• Converts local stdio MCP servers into endpoints other clients can use
• Manages multiple MCP services from one UI
• Provides fixed MCP endpoints for external Skills and bundled Skills
• Includes built-in tools such as file reading, command execution, multi-file editing, browser control, and adapter debugging
• Provides an AI Adapter that ingests tool definitions from AI coding tools (OpenAI/Anthropic protocol) and publishes them as MCP tools
• Supports path allowlists, command policies, execution limits, and manual approvals
• Keeps Skill usage token-light: Skills are described by small SKILL.md documents and only expanded when a client chooses to use them

Endpoint Shape

For a configured MCP server named ``:

SSE:  http:///api/v2/sse/
HTTP: http:///api/v2/mcp/

Skill endpoints are fixed:

External Skills: /api/v2/sse/__skills__
External Skills: /api/v2/mcp/__skills__
Bundled Skills:  /api/v2/sse/__builtin_skills__
Bundled Skills:  /api/v2/mcp/__builtin_skills__

The AI Adapter UI copies a user-friendly OpenAI/Anthropic-compatible Base URL for BYOK-style AI coding tools:

Base URL: http:///api/v2/ai/v1

The backend canonical AI Adapter base path remains /api/v2/ai. Clients can call these canonical protocol endpoints:

List models:  GET  /api/v2/ai/v1/models
Chat:         POST /api/v2/ai/v1/chat/completions
Responses:    POST /api/v2/ai/v1/responses
Messages:     POST /api/v2/ai/v1/messages
Token Count:  POST /api/v2/ai/v1/messages/count_tokens
Health:       GET  /api/v2/ai/health

For clients that automatically append another /v1 to the copied Base URL, the backend also accepts the compatible /api/v2/ai/v1/v1/... paths, including models, chat completions, responses, Anthropic messages, and token counting. Claude Code users do not need to remove /v1 from the Base URL copied from the UI.

If MCP Token is configured, clients should send:

Authorization: Bearer 

Typical Use

1. Open the app and set the listen address, for example 127.0.0.1:8765.
2. Add local MCP servers, such as a filesystem or Playwright stdio server.
3. Enable the bundled tools or add external Skill directories.
4. Configure allowed directories and command confirmation rules.
5. Start the gateway.
6. Copy the generated SSE or HTTP endpoint into your MCP client.

Example endpoint:

http://127.0.0.1:8765/api/v2/sse/playwright

Skills And Built-In Tools

The gateway can expose two kinds of Skill MCP servers:

• __skills__: Skills discovered from directories you add. Each Skill is backed by a SKILL.md.
• __builtin_skills__: bundled practical tools shipped with the gateway.

Bundled tools currently include:

• read_file
• shell_command
• multi_edit_file
• task-planning
• chrome-cdp
• chat-plus-adapter-debugger (business-specific)
• officecli
• codegraph

chat-plus-adapter-debugger targets the Chat Plus adapter workflow; keep it off for general-purpose agents.

This makes it possible to build agent-like workflows on top of normal MCP clients: inspect a project, read documentation, edit code, run commands, test behavior, and control a browser, while still routing everything through MCP.

AI Adapter (BYOK)

The AI Adapter accepts incoming connections from AI coding tools that support custom API endpoints (OpenAI or Anthropic protocol). When a tool connects, it sends its tool definitions in the request. The gateway extracts those tools, registers them as MCP tools, and exposes them through a dedicated MCP endpoint — so MCP clients can call the tools that the AI tool declared.

How it works:

1. Enable the AI Adapter toggle in the UI.
2. Add one or more API keys (or leave empty to accept all connections).
3. Copy the Base URL and configure it in your AI coding tool as the API endpoint.
4. The tool sends a request — the gateway extracts the system prompt and tool definitions, then creates an MCP server endpoint for that session.
5. Connect your MCP client to the session's MCP endpoint to call those tools.

Key points:

• The gateway does not run any AI model. It ingests tool definitions from AI tools and publishes them as MCP tools.
• Any model name is accepted — the gateway never validates it.
• Each connection creates a session, visible in the UI with protocol info, tool list, and real-time toggle controls.
• Supports three protocols: OpenAI Chat Completions, OpenAI Responses, and Anthropic Messages.

Safety

Some Skills and built-in tools can execute commands, edit files, or control local applications. Use Admin Token and MCP Token when exposing the gateway beyond your own machine, and configure allowed directories, confirmation rules, and execution limits before enabling high-risk tools.

You are responsible for the consequences of commands and tools you approve.

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: aiguicai
• Source: aiguicai/MCP-Gateway
• License: MIT

Install and usage instructions live in the source repository linked above.