# Mcp Links

> Mcp.Links 是一个基于 .NET 9.0 构建的模型上下文协议(MCP)聚合器，能够将多个 MCP 服务器集成到统一平台中，提供 Web 管理界面，支持多种协议(stdio、HTTP、SSE)，并内置 MCP 商店用于发现和管理各种 AI 工具和服务。

- **Type:** MCP server
- **Install:** `agentstack add mcp-sheng-jie-mcp-links`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [sheng-jie](https://agentstack.voostack.com/s/sheng-jie)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [sheng-jie](https://github.com/sheng-jie)
- **Source:** https://github.com/sheng-jie/Mcp.Links
- **Website:** https://mcplinks.cn

## Install

```sh
agentstack add mcp-sheng-jie-mcp-links
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

[简体中文](README_zh-cn.md) | [English](README.md)

# 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:

```bash
# 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:

```bash
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`)

```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`)

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

### 3. Build and Deploy with Docker

Build and run with Docker:

```bash
# Build the image
docker build -t mcp-links .

# Run the container
docker run -p 8080:8080 \
  -v $(pwd)/mcp.json:/app/mcp.json \
  -v $(pwd)/client-apps.json:/app/client-apps.json \
  mcp-links
```

### 4. Custom Configuration File

Specify a custom configuration file:

```bash
dotnet run --project src/Mcp.Links.Http/Mcp.Links.Http.csproj --mcp-file=/path/to/custom-mcp.json
```

## 🔧 Supported MCP Server Types

### Stdio Servers
- **Python-based**: Using `uvx` or `pip` installed packages
- **.NET-based**: Using `dnx` command with .NET tools
- **Node.js-based**: Using `npx` or globally installed packages

### HTTP Servers
- RESTful MCP servers with standard HTTP endpoints
- Custom authentication header support

### SSE (Server-Sent Events)
- Real-time streaming MCP servers
- Event-based communication

## 🎯 Use Cases

- **AI Development**: Aggregate multiple AI tools and services into a single MCP interface
- **Enterprise Integration**: Centralize various business tools and APIs
- **Development Workflow**: Combine code analysis, documentation, and deployment tools
- **Research Platform**: Integrate data analysis, visualization, and machine learning tools
- **Rapid Prototyping**: Quickly discover and integrate MCP servers from the built-in store
- **Multi-client Management**: Configure different tool sets for various AI clients (VS Code, Cursor, Claude Desktop)

## 🔒 Security Features

- **API Key Authentication**: Secure access control for client applications
- **Client-specific Server Access**: Granular permissions for different client applications
- **Environment Isolation**: Separate configurations for different environments
- **Request Validation**: Built-in request validation and error handling

## 🌐 Web Interface Features

The web management interface provides:

- **Server Management**: Add, edit, disable/enable MCP servers
- **MCP Store**: Browse and install MCP servers from a curated marketplace featuring 40+ pre-configured servers including:
  - **AI Services**: Time conversion, web search (Brave, Perplexity, Zhipu), image generation (EverArt, MiniMax)
  - **Development Tools**: GitHub/GitLab integration, Figma context, browser automation (Playwright, Puppeteer)
  - **Database Access**: PostgreSQL, Redis, Neon database management
  - **Content & Communication**: Slack integration, email sending (Mailtrap), note-taking (Flomo)
  - **Location Services**: Google Maps, Baidu Maps, Amap Maps with geocoding and routing
  - **Specialized Tools**: Blender 3D modeling, sequential thinking, AWS knowledge base retrieval
- **Real-time Monitoring**: View server status and communication logs
- **Tool Inspector**: Browse available tools from all connected servers
- **Client App Management**: Configure API keys and server access for different clients
- **Configuration Editor**: Direct editing of JSON configuration files
- **Internationalization**: Support for multiple languages (English, Chinese)

## 📊 Monitoring & Debugging

- **Health Checks**: Monitor the status of all connected MCP servers
- **Request Logging**: Track all MCP communications for debugging
- **Error Handling**: Comprehensive error reporting and recovery
- **Performance Metrics**: Monitor response times and server performance

## 🚀 Development & Extension

### Adding New MCP Servers

1. Update your `mcp.json` configuration
2. Restart the application or use hot-reload
3. Verify connectivity through the web interface

### Custom Transport Types

The system supports extending with custom transport implementations by implementing the transport interfaces in the core library.

## 🤝 Contributing

Contributions are welcome! Please feel free to submit pull requests, report issues, or suggest new features.

## 📄 License

This project is licensed under the terms specified in the [LICENSE.txt](LICENSE.txt) file.

---

**Built with ❤️ using .NET 9.0, AntBlazor, and the MCP C# SDK**

## Source & license

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

- **Author:** [sheng-jie](https://github.com/sheng-jie)
- **Source:** [sheng-jie/Mcp.Links](https://github.com/sheng-jie/Mcp.Links)
- **License:** MIT
- **Homepage:** https://mcplinks.cn

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-sheng-jie-mcp-links
- Seller: https://agentstack.voostack.com/s/sheng-jie
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.