MCP客户端桌面应用

MCP Desk是一个基于Electron、React和TypeScript构建的桌面应用程序,用于与多能力平台(MCP)服务器交互,提供AI代理聊天、工具使用和设置管理功能。

  • by debsouryadatta
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 debsouryadatta/mcp-desk

使用说明


MCP Desk

MCP Desk - Your Own MCP Client built with Electron, React, and TypeScript.

View Demo · Report Bug · Request Feature

应用程序界面库

通过以下截图探索MCP Desk的视觉设计和功能:

以下是一些展示 mcp-desk 应用程序:





(back to top)

Table of Contents
  1. Application Interface Gallery
  2. About The Project
  3. Getting Started
  4. Usage
  5. Contributing
  6. Contact

关于项目

mcp-desk 是一个桌面应用程序,旨在作为与多功能平台(MCP)服务器交互的客户端。它在Electron框架内使用现代网络技术构建,提供了一个用户友好的界面,用于管理MCP配置和利用AI代理功能,包括由OpenRouter通过Langchain等模型支持的工具使用。

该应用程序具有与AI代理交互的聊天界面、MCP服务器配置的设置管理以及导入/导出应用程序设置的能力。

(back to top)

主要特点

  • 电子桌面应用程序:跨平台兼容性(Windows、macOS、Linux)。
  • 反应前端:使用React和TypeScript构建的现代UI。
  • Shadcn UI和顺风CSS:利用Shadcn UI组件和Tailwind CSS(v3)实现一致和实用优先的样式方法。
  • MCP客户端:使用连接到MCP服务器并与之交互 easy-mcp-use.
  • AI代理聊天:由Langchain和OpenRouter型号提供支持的集成聊天界面。
  • 工具使用:支持能够调用工具的AI模型。
  • 模型选择:允许用户选择不同的LLM型号。
  • 设置管理:配置MCP服务器详细信息并管理应用程序设置。
  • 导入/导出:通过JSON文件备份和还原应用程序设置(存储在localStorage中)。
  • Markdown支持:在聊天UI中以Markdown格式呈现助手消息。
  • IPC通信:主进程和渲染器进程之间的高效通信。

(back to top)

构建于

(back to top)

入门指南

按照以下步骤获取的本地副本 mcp-desk 为发展或贡献而启动和运行。如果您只想使用该应用程序,请参阅 下载预构建应用程序 下面的部分。

(back to top)

下载预构建应用程序

如果你只是想使用 mcp-desk 无需设置开发环境,您可以直接从GitHub发布页面下载适用于您的操作系统的最新预构建版本:

下载适合您系统的文件(.dmg 对于macOS, .exe 对于Windows),并像安装任何其他应用程序一样安装它。

Linux用户须知:目前,Linux的预构建包在版本中不可用。Linux用户应该遵循 安装 和 构建 在本地设置项目然后运行的说明 pnpm build:linux 以生成Linux分发文件。

(back to top)

先决条件(发展)

  • Node.js(检查 package.json 特定版本的发动机或项目要求)
  • pnpm 包管理器
    npm install -g pnpm
    

安装

  1. 克隆存储库(必要时更新URL)
    git clone https://github.com/debsouryadatta/mcp-desk.git
    cd mcp-desk
    
  2. 使用pnpm安装依赖项
    pnpm install
    

(back to top)

发展

要在热重新加载的开发模式下运行应用程序,请执行以下操作:

pnpm run dev

(back to top)

构建

要构建分发应用程序,请执行以下操作:

# For Windows
pnpm run build:win

# For macOS
pnpm run build:mac

# For Linux
pnpm run build:linux

构建的应用程序包将位于 dist 或由指定的相关输出目录 electron-builder.

(back to top)

用法

启动应用程序后(pnpm run dev 或通过运行构建的可执行文件):

  1. 配置MCP服务器:导航到设置部分以输入MCP服务器配置详细信息。
  2. 选择LLM型号:从可用选项中选择您喜欢的语言模型。
  3. 通过聊天互动:使用聊天界面向配置的AI代理发送请求。
  4. 管理设置:使用设置中的导入/导出功能备份或还原配置。

有关更详细的使用说明,请参阅应用程序的UI。

(back to top)

贡献

欢迎投稿!如果您有改进建议 mcp-desk,请随时贡献。

  1. 分叉项目
  2. 创建功能分支(git checkout -b feature/AmazingFeature)
  3. 提交您的更改(git commit -m 'Add some AmazingFeature')
  4. 推到分支机构(git push origin feature/AmazingFeature)
  5. 打开拉取请求

(back to top)

联系

Debsourya Datta-X个人资料 @债务005 -电子邮件 debsouryadatta@gmail.com

项目链接: https://github.com/debsouryadatta/mcp-desk

(back to top)