mcp-proxy-server
An MCP proxy server that aggregates and serves multiple MCP resource servers through a single interface
GitHub Stars
157
User Rating
Not Rated
Favorites
0
Views
6
Forks
43
Issues
10
Installation
Difficulty
IntermediateEstimated Time
10-20 minutes
Requirements
Node.js: 18.0.0以上
npm: 8.0.0以上
+1 more
Installation
Installation
Prerequisites
Node.js: 18.0.0 or higher
npm: 8.0.0 or higher
Claude Desktop: Latest version
Installation Steps
1. Clone Repository
bash
git clone https://github.com/adamwattis/mcp-proxy-server
cd mcp-proxy-server
2. Install Dependencies
bash
npm install
3. Configure Claude Desktop
Editclaude_desktop_config.json
to add the MCP server:
json
{
"mcpServers": {
"mcp-proxy": {
"command": "/path/to/mcp-proxy-server/build/index.js",
"env": {
"MCP_CONFIG_PATH": "/absolute/path/to/your/config.json",
"KEEP_SERVER_OPEN": "1"
}
}
}
}
4. Start Server
bash
npm start
Troubleshooting
Common Issues
Issue: Server won't start Solution: Check Node.js version and reinstall dependencies. Issue: Not recognized by Claude Desktop Solution: Verify configuration file path and syntax.Configuration
Configuration
Basic Configuration
Claude Desktop Setup
Edit~/.config/claude-desktop/claude_desktop_config.json
(macOS/Linux) or
%APPDATA%\Claude\claude_desktop_config.json
(Windows):
json
{
"mcpServers": {
"mcp-proxy": {
"command": "/path/to/mcp-proxy-server/build/index.js",
"env": {
"MCP_CONFIG_PATH": "/absolute/path/to/your/config.json",
"KEEP_SERVER_OPEN": "1"
}
}
}
}
Environment Variables
Set the following environment variables as needed:bash
export API_KEY="your-api-key"
export DEBUG="true"
Configuration Examples
Basic Configuration
json
{
"servers": [
{
"name": "Server 1",
"transport": {
"command": "/path/to/server1/build/index.js"
}
}
]
}
Examples
Examples
Basic Usage
Here are basic usage examples for the MCP server:Using with Claude Desktop
1Verify MCP Server Startup
Open Claude Desktop and confirm that the configuration has been loaded correctly.
2Execute Basic Commands
Available tools from this MCP server:
- tool1: Description of tool1
- tool2: Description of tool2
Programmatic Usage
javascript
// JavaScript example (Node.js)
const { MCPClient } = require('@modelcontextprotocol/client');
const client = new MCPClient();
await client.connect();
// Execute tool
const result = await client.callTool('toolName', {
parameter1: 'value1',
parameter2: 'value2'
});
console.log(result);
Advanced Examples
Automation Script
bash
#!/bin/bash
Batch processing example
for file in *.txt; do
mcp-tool process "$file"
done
API Integration
python
Python example
import requests
import json
def call_mcp_tool(tool_name, params):
response = requests.post(
'http://localhost:3000/mcp/call',
json={
'tool': tool_name,
'parameters': params
}
)
return response.json()
Usage example
result = call_mcp_tool('analyze', {
'input': 'sample data',
'options': {'format': 'json'}
})
Use Cases
Integrating multiple AI resources and accessing them through a single API endpoint.
An application that centrally manages different MCP tools, providing a seamless experience for users.
A project that aggregates data analysis tools from multiple backends and consolidates results.
A system that aggregates streaming data from multiple MCP servers for real-time data processing.
Additional Resources
Author Information
12
Followers
13
Repositories
2
Gists
0
Total Contributions
Related MCPs
The MCP Proxy Server is a powerful tool for managing and connecting multiple MCP servers. It allows flexible control of tools and endpoint authentication through an intuitive web UI. Key features include real-time monitoring of installation output and support for concurrent connections via streamable HTTP endpoints.
n8n-mcp-server
1308
MCP server that provides tools and resources for interacting with n8n API