MCP Access Point

v1.0.0โ€ขDeveloper Toolsโ€ขstable

๐Ÿ“‡ โ˜๏ธ ๐Ÿ  ๐ŸŽ ๐ŸชŸ ๐Ÿง - Turn a web service into an MCP server in one click without making any code changes.

gatewaymcpmcp-serversproxy
Share:
173
Stars
0
Downloads
0
Weekly
0/5

What is MCP Access Point?

MCP Access Point is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ๐Ÿ“‡ โ˜๏ธ ๐Ÿ  ๐ŸŽ ๐ŸชŸ ๐Ÿง - turn a web service into an mcp server in one click without making any code changes.

๐Ÿ“‡ โ˜๏ธ ๐Ÿ  ๐ŸŽ ๐ŸชŸ ๐Ÿง - Turn a web service into an MCP server in one click without making any code changes.

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • ๐Ÿ“‡ โ˜๏ธ ๐Ÿ  ๐ŸŽ ๐ŸชŸ ๐Ÿง - Turn a web service into an MCP server in one

Use Cases

Convert any web service into an MCP server without code changes.
sxhxliang

Maintainer

LicenseMIT
Languagerust
Versionv1.0.0
UpdatedMay 22, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx mcp-access-point

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use MCP Access Point

MCP Access Point is a Rust-based gateway that converts any existing HTTP/REST web service โ€” described by an OpenAPI specification โ€” into a fully functional MCP server, with no changes required to the original service. It proxies requests from MCP clients (Claude Desktop, VS Code, Cursor, Windsurf) to your upstream APIs, handling protocol translation transparently. DevOps engineers and platform teams use it to expose internal microservices, third-party REST APIs, or legacy HTTP endpoints to AI agents through a single, centrally managed gateway.

Prerequisites

  • Docker installed (recommended) or Rust toolchain for building from source
  • An OpenAPI (Swagger) JSON or YAML specification for the web service you want to expose
  • The upstream web service must be network-accessible from the machine running MCP Access Point
  • An MCP-compatible client such as Claude Desktop, Cursor, or VS Code with MCP support
1

Clone the repository

Clone the mcp-access-point repository to get the source code and example configuration files.

git clone https://github.com/sxhxliang/mcp-access-point.git
cd mcp-access-point
2

Create a config.yaml file

Define your upstream service and the path to its OpenAPI spec. The mcps section maps service IDs to specs; the upstreams section defines where to forward requests.

# config/config.yaml
mcps:
  - id: my-service
    upstream_id: 1
    path: config/openapi.json

upstreams:
  - id: 1
    nodes:
      "127.0.0.1:8090": 1
    type: roundrobin
    scheme: http
    headers:
      X-API-Key: "your-api-key-here"
3

Place your OpenAPI spec

Copy your service's OpenAPI JSON or YAML file to the path referenced in config.yaml (e.g. config/openapi.json).

cp /path/to/your/openapi.json config/openapi.json
4

Run with Docker

Launch the gateway using Docker, mounting your config directory and exposing the default port 8080.

docker run -d --name mcp-access-point --rm \
  -p 8080:8080 \
  -e port=8080 \
  -v $(pwd)/config:/app/config \
  ghcr.io/sxhxliang/mcp-access-point:main
5

Run from source (alternative)

If you prefer to build and run without Docker, use Cargo. The Rust toolchain must be installed.

cargo run -- -c config/config.yaml
6

Connect your MCP client to the gateway

Point Claude Desktop or another MCP client at the SSE or Streamable HTTP endpoint exposed by the gateway. The SSE endpoint is available at http://localhost:8080/sse and Streamable HTTP at http://localhost:8080/mcp.

MCP Access Point Examples

Client configuration

Connect Claude Desktop to the MCP Access Point gateway using the npx launcher. The gateway must already be running before Claude starts.

{
  "mcpServers": {
    "mcp-access-point": {
      "command": "npx",
      "args": ["mcp-access-point"],
      "env": {
        "port": "8080"
      }
    }
  }
}

Prompts to try

Once an upstream API is registered, Claude can call its endpoints as MCP tools.

- "List the available tools from the connected API gateway"
- "Call the my-service API to fetch the current status endpoint"
- "Use the upstream service to create a new record with these details: name='Test', status='active'"

Troubleshooting MCP Access Point

The gateway starts but returns 'upstream connection refused' when a tool is called

Verify the upstream host and port in config.yaml match where your web service is actually running. Test connectivity with 'curl http://127.0.0.1:8090/your-endpoint'. If the service is on a different host or inside Docker, update the nodes address accordingly.

MCP client cannot connect to the gateway SSE endpoint

Confirm the Docker container is running with 'docker ps' and that port 8080 is mapped correctly. Try 'curl http://localhost:8080/sse' โ€” you should see a streaming response. Check that no firewall or security software is blocking localhost connections on port 8080.

OpenAPI spec is not being parsed correctly and tools are missing

Validate your OpenAPI JSON/YAML with a linter such as Swagger Editor (editor.swagger.io). Ensure the path in config.yaml points to the correct location inside the container (relative to /app). Restart the container after any config or spec file change with 'docker restart mcp-access-point'.

Frequently Asked Questions about MCP Access Point

What is MCP Access Point?

MCP Access Point is a Model Context Protocol (MCP) server that ๐Ÿ“‡ โ˜๏ธ ๐Ÿ  ๐ŸŽ ๐ŸชŸ ๐Ÿง - turn a web service into an mcp server in one click without making any code changes. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install MCP Access Point?

Follow the installation instructions on the MCP Access Point GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with MCP Access Point?

MCP Access Point works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is MCP Access Point free to use?

Yes, MCP Access Point is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "mcp-access-point": { "command": "npx", "args": ["-y", "mcp-access-point"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide โ†’

Ready to use MCP Access Point?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides