简体中文 | English

Mcp.Links

A powerful Model Context Protocol (MCP) aggregator built with .NET 9.0 that enables seamless integration and management of multiple MCP servers. This project provides both HTTP and command-line interfaces for aggregating various MCP servers into a unified platform.

🚀 Features

• Multi-Protocol Support: Aggregates MCP servers via stdio, HTTP, and SSE protocols
• Web Management Interface: Intuitive Blazor-based UI for managing MCP servers and client applications
• MCP Store: Built-in marketplace for discovering and installing pre-configured MCP servers
• Authentication: Built-in API key authentication for secure access
• Real-time Inspector: Monitor and inspect MCP server communications
• Client App Management: Configure different client applications with specific MCP server access
• Tool Aggregation: Seamlessly combine tools from multiple MCP servers
• Docker Support: Ready-to-deploy containerized solution
• Multi-environment Support: Configurable for development and production environments

📦 Installation & Usage

⚡ Quick Start

Get started quickly using the pre-built Docker image:

# Run with default configuration
docker run -p 8080:8080 ghcr.io/sheng-jie/mcp-links:v0.4

# Run with custom configuration files
docker run -p 8080:8080 \
  -v $(pwd)/mcp.json:/app/mcp.json \
  -v $(pwd)/client-apps.json:/app/client-apps.json \
  ghcr.io/sheng-jie/mcp-links:v0.4

The application will be available at http://localhost:8080 with the MCP endpoint at /mcp.

📋 Prerequisites

• .NET 9.0 SDK
• Node.js (for running Node-based MCP servers)
• Python 3.x with uv/uvx (for Python-based MCP servers)

1. HTTP Server Mode (Recommended)

Run the web-based management interface:

dotnet run --project src/Mcp.Links.Http/Mcp.Links.Http.csproj

The server will start on http://localhost:5146 with the MCP endpoint available at /mcp.

Visit http://localhost:5146/mcp/env-check to check if your local environment is satisfied.

2. Configuration

MCP Servers Configuration (mcp.json)

{
  "mcpServers": {
    "fetch": {
      "enabled": true,
      "type": "stdio",
      "command": "uvx",
      "args": ["mcp-server-fetch"],
      "env": {
        "node-env": "dev",
        "port": "3300"
      }
    },
    "time": {
      "enabled": true,
      "type": "stdio", 
      "command": "uvx",
      "args": ["mcp-server-time", "--local-timezone=Asia/Shanghai"]
    },
    "microsoft-learn": {
      "enabled": false,
      "type": "http",
      "url": "https://learn.microsoft.com/api/mcp"
    }
  }
}

Client Applications Configuration (client-apps.json)

{
  "mcpClients": [
    {
      "appId": "vscode",
      "appKey": "your-api-key-here",
      "name": "VS Code",
      "description": "VS Code MCP client",
      "mcpServerIds": ["fetch", "time"]
    }
  ]
}