MCPcopy Index your code
hub / github.com/TimeCyber/MCP-X

github.com/TimeCyber/MCP-X @v0.0.4

Chat with this repo
repository ↗ · DeepWiki ↗ · release v0.0.4 ↗ · + Follow
673 symbols 1,628 edges 162 files 2 documented · 0% updated 8mo agov0.0.4 · 2025-07-20★ 139
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

MCP-X Agent 🤿 🤖

English | 中文

GitHub stars GitHub forks GitHub watchers GitHub repo size GitHub language count GitHub top language GitHub last commit

MCP-X 是一个开源的 MCP Client 桌面应用,能够无缝集成所有支持 function calling 能力的大模型(LLMs)。✨

MCP-X Demo

使用案例 🎯

AI 智能内容分析

MCP-X 擅长通过强大的 AI 代理分析和理解各种类型的内容。以下是美食内容分析的示例:

美食分析示例

展示的核心功能: - 🍽️ 美食内容分析:详细解析菜品、食材和营养信息 - 🎯 精准推荐:基于用户偏好的个性化建议 - 📊 结构化输出:组织清晰的信息分类展示 - 💬 交互式对话:自然流畅的对话体验和全面回应

适用场景: - 美食博主和内容创作者 - 营养师和健康专业人士 - 餐厅老板和厨师 - 任何对美食分析和推荐感兴趣的人

这展示了 MCP-X 如何将简单的查询转化为详细、可操作的洞察,适用于各个领域。

最新亮点

我们推出了两项重大更新,旨在提升您的使用体验:

🚀 全新智能体系统

MCP-X 现已成为一个完整的智能体平台。 - 新增智能体侧边栏: 在这里发现、管理和搜索不同领域的专业AI智能体。 - 一键对话: 根据当前任务,随时切换和对话所需智能体。 - 智能体详情: 查看每个智能体的具体能力、技能和使用示例。 - 清晰分类: 智能体已按内容创作、数据分析、编程等类别进行整理。

🎨 焕然一新的界面

我们重新设计了应用界面,使其更简洁、更直观。 - 全新侧边导航: 新的导航栏让您可以快速访问对话、智能体、工具、模型和系统设置。 - 更清晰的图标: 导航图标增加了文字说明,功能一目了然。 - 统一的设计风格: 我们统一了配色和布局,使整体观感更加协调、专业。

此次更新还包括将图标库升级为更专业的 react-icons,并对底层的CSS和组件进行了多项优化,以提升性能。

功能特性 🎯

  • 🌐 通用大模型支持:兼容 ChatGPT、Anthropic、Ollama 及所有 OpenAI 兼容模型
  • 💻 跨平台:支持 Windows、MacOS 和 Linux
  • 🔄 模型上下文协议:支持 stdio 和 SSE 模式下的 MCP AI agent 无缝集成
  • 🌍 多语言支持:支持繁体中文、简体中文、英文、西班牙语,更多语言即将上线
  • ⚙️ 高级 API 管理:支持多 API Key 和模型切换
  • 💡 自定义指令:可个性化系统提示词,定制 AI 行为
  • 🔄 自动更新机制:自动检测并安装最新应用版本

下载与安装 ⬇️

获取 MCP-X 最新版本: Download

Windows 用户:🪟 - 下载 .exe 版本 - 已内置 Python 和 Node.js 环境

MacOS 用户:🍎 - 下载 .dmg 版本 - 需自行安装 Python 和 Node.js(含 npx uvx)环境 - 按照安装提示完成设置

Linux 用户:🐧 - 下载 .AppImage 版本 - 需自行安装 Python 和 Node.js(含 npx uvx)环境 - Ubuntu/Debian 用户: - 可能需要添加 --no-sandbox 参数 - 或修改系统设置以允许沙盒 - 运行 chmod +x 赋予 AppImage 可执行权限

MCP 小贴士

系统自带默认的 echo MCP Server,你的大模型可以通过 MCP 访问更强大的工具。以下是两个新手友好工具的快速上手方法:Fetch 和 Youtube-dl。

快速配置

将以下 JSON 配置添加到 MCP-X 的 MCP 设置中以启用这两个工具:

 "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
    }
  }

使用 SSE 服务器作为 MCP

你也可以通过 SSE(Server-Sent Events)连接外部 MCP 服务器。将如下配置添加到 MCP-X 的 MCP 设置中:

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

构建 🛠️

详见 BUILD.md

联系我们 🌐

Extension points exported contracts — how you extend this code

DatabaseOperations (Interface)
(no doc) [3 implementers]
services/database/index.ts
IMCPServerManager (Interface)
(no doc) [2 implementers]
services/mcpServer/interface.ts
ProcessEnv (Interface)
(no doc)
electron/electron-env.d.ts
ProxySettings (Interface)
(no doc)
electron/main/proxy.ts
MCPClientConfig (Interface)
(no doc)
services/client.ts
FileProcessingResult (Interface)
(no doc)
services/webServer.ts
AbortedResponse (Interface)
(no doc)
services/processQuery.ts
iQueryInput (Interface)
(no doc)
services/utils/types.ts

Core symbols most depended-on inside this repo

getInstance
called by 75
services/routes/agent.ts
on
called by 50
src/electron.d.ts
invoke
called by 34
src/electron.d.ts
initialize
called by 13
services/mcpServer/interface.ts
send
called by 13
src/electron.d.ts
getPrompt
called by 12
services/prompt/index.ts
off
called by 12
src/electron.d.ts
getHeaders
called by 11
services/database/index.ts

Shape

Function 436
Method 130
Interface 79
Class 26
Enum 2

Languages

TypeScript100%

Modules by API surface

services/database/index.ts51 symbols
src/views/Overlay/Tools.tsx33 symbols
src/views/Welcome.tsx19 symbols
src/views/Chat/ChatInput.tsx18 symbols
src/views/Overlay/Model/Popup/index.tsx17 symbols
src/services/agentService.ts17 symbols
services/prompt/index.ts17 symbols
services/mcpServer/index.ts16 symbols
src/views/Chat/Message.tsx14 symbols
src/views/Setup/ModelConfigForm.tsx13 symbols
src/views/Overlay/Model/KeyPopup.tsx13 symbols
services/routes/agent.ts13 symbols

For agents

$ claude mcp add MCP-X \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact