# MCP X

> 这是一个MCP客户端，让你轻松配置各个大模型，对接各种MCP Server而开发。This is an MCP client that allows you to easily configure various large models and develop interfaces with various MCP servers.

- **Type:** MCP server
- **Install:** `agentstack add mcp-timecyber-mcp-x`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [TimeCyber](https://agentstack.voostack.com/s/timecyber)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** Apache-2.0
- **Upstream author:** [TimeCyber](https://github.com/TimeCyber)
- **Source:** https://github.com/TimeCyber/MCP-X
- **Website:** https://www.mcp-x.com

## Install

```sh
agentstack add mcp-timecyber-mcp-x
```

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

## About

# MCP-X Agent 🤿 🤖

[English](README.md) | [中文](README_zh.md)

MCP-X is an open-source MCP Host Desktop Application that seamlessly integrates with any LLMs supporting function calling capabilities. ✨

## Use Cases 🎯

### AI Agent
MCP-X good at agent and understanding various types of content through its powerful AI agents. Here's an example of food content agent:

**Key Features Demonstrated:**
- 🍽️ **Food Content Analysis**: Detailed breakdown of dishes, ingredients, and nutritional information
- 🎯 **Targeted Recommendations**: Personalized suggestions based on user preferences
- 📊 **Structured Output**: Well-organized information with clear categorization
- 💬 **Interactive Chat**: Natural conversation flow with comprehensive responses

**Perfect for:**
- Food bloggers and content creators
- Nutritionists and health professionals
- Restaurant owners and chefs
- Anyone interested in food analysis and recommendations

This showcases how MCP-X can transform simple queries into detailed, actionable insights across various domains.

## What's New

We've just rolled out major updates to improve your experience:

### 📚 Brand New Knowledge Base Feature (v0.1.0)
MCP-X now supports powerful knowledge base management!
- **Knowledge Management**: Upload, view, search, and delete knowledge documents (supports txt, md, json, csv, xml, html formats)
- **Smart Search**: Full-text search by filename and content with highlighted matching results
- **Chat References**: One-click reference to knowledge base documents in chat, AI can answer based on your knowledge base content
- **Document Preview**: Real-time document content preview with file metadata display
- **Responsive Design**: Perfect adaptation for desktop and mobile devices

### 🚀 AI Agent System
MCP-X as a full-fledged AI agent platform.
- **New Agent Sidebar**: Discover, manage, and search for specialized AI agents.
- **One-Click Talk**: Instantly talk to any agent for your current task.
- **Agent Profiles**: See what each agent can do, with details on their skills and example uses.
- **Organized for You**: Agents are sorted into categories like content creation, data analysis, and programming.

### 🎨 A Fresh New Look
We've redesigned the app to be cleaner and more intuitive.
- **New Side Navigation**: A permanent sidebar gives you quick access to Chat, Agents, Knowledge Base, Tools, Models, and System settings.
- **Clearer Icons**: Navigation icons now have text labels so you know exactly where you're going.
- **Consistent Design**: We've unified the color scheme and layout for a more polished feel.

This update also includes a move to a more professional icon set (`react-icons`) and various under-the-hood CSS and component optimizations for better performance.

## Features 🎯

- 🌐 **Universal LLM Support**: Compatible with ChatGPT, Anthropic, Ollama and OpenAI-compatible models
- 💻 **Cross-Platform**: Available for Windows, MacOS, and Linux
- 📚 **Knowledge Base Management**: Upload, search, and reference knowledge documents, let AI answer based on your materials
- 🔄 **Model Context Protocol**: Enabling seamless MCP AI agent integration on both stdio and SSE mode
- 🤖 **AI Agent System**: Rich professional AI agents covering various domain-specific needs
- 🌍 **Multi-Language Support**: Traditional Chinese, Simplified Chinese, English, Spanish with more coming soon
- ⚙️ **Advanced API Management**: Multiple API keys and model switching support
- 💡 **Custom Instructions**: Personalized system prompts for tailored AI behavior
- 🔄 **Auto-Update Mechanism**: Automatically checks for and installs the latest application updates

## Download and Install ⬇️

Get the latest version of MCP-X:
[](https://github.com/TimeCyber/MCP-X/releases/latest)

For Windows users: 🪟
- Download the .exe version
- Python and Node.js environments are pre-installed

For MacOS users: 🍎
- Download the .dmg version
- You need to install Python and Node.js (with npx uvx) environments yourself
- Follow the installation prompts to complete setup

For Linux users: 🐧
- Download the .AppImage version
- You need to install Python and Node.js (with npx uvx) environments yourself
- For Ubuntu/Debian users:
  - You may need to add `--no-sandbox` parameter
  - Or modify system settings to allow sandbox
  - Run `chmod +x` to make the AppImage executable

## MCP Tips

While the system comes with a default echo MCP Server, your LLM can access more powerful tools through MCP. Here's how to get started with two beginner-friendly tools: Fetch and Youtube-dl.

### Quick Setup

Add this JSON configuration to your MCP-X MCP settings to enable both tools:

```json
 "mcpServers":{
    "fetch": {
      "command": "uvx",
      "args": [
        "mcp-server-fetch",
        "--ignore-robots-txt"
      ],
      "enabled": true
    },
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/path/to/allowed/files"
      ],
      "enabled": true
    },
    "youtubedl": {
      "command": "npx",
      "args": [
        "@kevinwatt/yt-dlp-mcp"
      ],
      "enabled": true
    }
  }
```

### Using SSE Server for MCP

You can also connect to an external MCP server via SSE (Server-Sent Events). Add this configuration to your MCP-X MCP settings:

```json
{
  "mcpServers": {
    "MCP_SERVER_NAME": {
      "enabled": true,
      "transport": "sse",
      "url": "YOUR_SSE_SERVER_URL"
    }
  }
}
```

### Additional Setup for yt-dlp-mcp

yt-dlp-mcp requires the yt-dlp package. Install it based on your operating system:

#### Windows
```bash
winget install yt-dlp
```

#### MacOS
```bash
brew install yt-dlp
```

#### Linux
```bash
pip install yt-dlp
```

## Usage Guide 📖

### How to use Knowledge Base:

1. **Add Documents**: Click "Knowledge Base" in sidebar → Upload supported file formats (txt, md, json, csv, xml, html)
2. **Search Documents**: Use search box in knowledge base page, supports search by filename and content
3. **Reference Documents**: Click knowledge base button (📚) in chat → Search and select document → Auto-insert reference  
4. **Manage Documents**: Preview, delete documents, view detailed information and metadata

For more details, see [CHANGELOG.md](CHANGELOG.md).

## Build 🛠️

See [BUILD.md](BUILD.md) for more details.

## Connect With Us 🌐
- 💬 Join our [Home](https://mcp-x.com/)
- 🐦 Follow us on [RedNote](https://www.xiaohongshu.com/user/profile/6833b89f000000000e0137ca)
- ⭐ Star us on GitHub
- 🐛 Report issues on our [Issue Tracker](https://github.com/TimeCyber/MCP-X/issues)

## Source & license

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

- **Author:** [TimeCyber](https://github.com/TimeCyber)
- **Source:** [TimeCyber/MCP-X](https://github.com/TimeCyber/MCP-X)
- **License:** Apache-2.0
- **Homepage:** https://www.mcp-x.com

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-timecyber-mcp-x
- Seller: https://agentstack.voostack.com/s/timecyber
- 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%.