MCP-X
- desktop-chat
This is an MCP client that allows you to easily configure various large models and develop interfaces with various MCP servers.
About
What is MCP-X?
MCP-X is an open-source MCP Host Desktop Application that integrates with any LLM supporting function calling. It runs on Windows, macOS, and Linux and is designed for developers and users who want to connect AI agents to external tools via the Model Context Protocol.
How to use MCP-X?
Download the latest release from GitHub and install it. Windows users get Python and Node.js pre‑installed; macOS and Linux users must install them separately. After installation, add MCP server configurations in JSON format (stdio or SSE) to the MCP‑X settings. The README provides quick‑start examples for fetch, filesystem, and youtube‑dl servers.
Key features of MCP-X
- Works with ChatGPT, Anthropic, Ollama, and OpenAI‑compatible models
- Cross‑platform: Windows, macOS, and Linux
- Supports MCP servers via stdio and SSE transport
- Multi‑language interface (Traditional Chinese, Simplified Chinese, English, Spanish)
- Manage multiple API keys and switch models
- Custom system prompts for tailored AI behavior
- Auto‑update mechanism for latest releases
Use cases of MCP-X
- Connect AI assistants to fetch web content while ignoring robots.txt
- Allow AI to manage files on a specified local directory
- Enable AI to download YouTube metadata and transcripts
- Switch between different LLM providers and API keys in one app
- Personalize AI responses with custom instruction prompts
FAQ from MCP-X
—
Details
- Author
- TimeCyber
- Category
- desktop-chat
- Repository
- timecyber/mcp-x
MCP-X Agent 🤿 🤖
MCP-X is an open-source MCP Host Desktop Application that seamlessly integrates with any LLMs supporting function calling capabilities. ✨
Features 🎯
- 🌐 Universal LLM Support: Compatible with ChatGPT, Anthropic, Ollama and OpenAI-compatible models
- 💻 Cross-Platform: Available for Windows, MacOS, and Linux
- 🔄 Model Context Protocol: Enabling seamless MCP AI agent integration on both stdio and SSE mode
- 🌍 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:
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:
"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:
{
"mcpServers": {
"MCP_SERVER_NAME": {
"enabled": true,
"transport": "sse",
"url": "YOUR_SSE_SERVER_URL"
}
}
}
Build 🛠️
See BUILD.md for more details.
