mcp-proxy-server
About
# mcp-proxy-server A proxy server for Model Context Protocol (MCP) that allows connections to multiple backend MCP servers. ## Getting Started ### Installation ### Globally Install the package globally: ```bash npm install -g @pyleeai/mcp-proxy-server ``` ### As a library Install it in your project: ```bash npm…
Explore
- Acts as a proxy for multiple backend MCP servers
- Configurable via a remote JSON configuration file
- Optional logging to a specified file path
- Can be installed globally or used as a library
- Built with Bun and designed for extensibility
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:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
mcp-proxy-serverCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
If installed globally:
mcp-proxy-server
- The CONFIGURATION_URL is required.
- _The LOG_PATH is optional_.
The CONFIGURATION_URL points to JSON that contains the configuration for the proxy server. It should have the following structure:
{
"mcp": {
"servers": {
"fetch": {
"args": [
"mcp-server-fetch"
],
"command": "uvx"
},
"filesystem": {
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"."
],
"command": "npx"
}
}
}
}
Start the server:
bun start
``bash
The release process is defined in .goreleaser.yaml` and includes:
- Building for multiple platforms (Linux, macOS, Windows)
- Support for both x64 and arm64 architectures
- Creating distributable archives
- Generating changelogs
- Creating GitHub releases
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp-proxy-server": {
"mcp-proxy-server-pyleeai": {
"command": "bun",
"args": [
"start"
]
}
}
}
}McpServers
{
"mcp-proxy-server-pyleeai": {
"command": "bun",
"args": [
"start"
]
}
}A proxy server for Model Context Protocol (MCP) that allows connections to multiple backend MCP servers.
Getting Started
Installation
Globally
Install the package globally:npm install -g @pyleeai/mcp-proxy-server
As a library
Install it in your project:
npm install @pyleeai/mcp-proxy-server
Usage
If installed globally:
mcp-proxy-server
Configuration
The MCP Proxy Server can be configured using environment variables.
CONFIGURATION_URL="http://example.com/configuration"
LOG_PATH=./logs/mcp-proxy-server.log
Environment Variables
- The CONFIGURATION_URL is required. - _The LOG_PATH is optional_.Configuration JSON
The CONFIGURATION_URL points to JSON that contains the configuration for the proxy server. It should have the following structure:{
"mcp": {
"servers": {
"fetch": {
"args": [
"mcp-server-fetch"
],
"command": "uvx"
},
"filesystem": {
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"."
],
"command": "npx"
}
}
}
}
Contributing
Contributions are welcome! Here's how you can contribute to the project:
Prerequisites
- Bun v1.2.2 or later
Setup
1. Clone the repository:
git clone https://github.com/your-username/mcp-proxy-server.git
cd mcp-proxy-server
2. Install dependencies:
bun install
Usage
Running the Server
Start the server:
bun start
Scripts
The project includes several npm scripts to help with development:
- bun lint - Lints the codebase using Biome
- bun format - Formats the codebase using Biome
- bun check - Runs both lint and format checks
- bun typecheck - Checks TypeScript types without emitting output
- bun test - Runs all tests
- bun start - Starts the development server
- bun build - Builds the project
- bun inspector - Runs the MCP inspector tool
Code Style
This project uses Biome for code formatting and linting. Please ensure your code follows these standards by running:
bun check
Testing
The project uses Bun's built-in test runner for comprehensive testing.
Running Tests
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
