Joey MCP客户
Desktop builds (macOS, Windows, Linux) are available in GitHub Releases. Windows and Linux builds are experimental.
使用Flutter构建的跨平台聊天应用程序，通过以下方式连接到AI模型 开放路由 远程 主控程序 （模型上下文协议）服务器通过流式HTTP。
主要特点
- 🔌 完全MCP支持 --通过工具调用、采样、启发、OAuth、会话恢复和进度通知连接到远程MCP服务器
- 🤖 数百种AI模型 --访问OpenRouter上的任何型号，在对话中切换型号，并跟踪每条消息的令牌使用情况和成本
- 🔄 代理工具使用 --自动代理循环，执行MCP工具并将结果反馈给LLM，直到任务完成
- 📎 图像和音频附件 --从图库/相机/剪贴板附加图像或在线录制音频，并在线显示工具返回的媒体
- 📱 交叉平台的 --在iOS、Android、macOS、Windows和Linux上本机运行
所有功能
聊天
- 与持久本地存储（SQLite）的多次对话
- 带有推理/思维显示的实时流式响应
- 完整的标记渲染，包括代码块、美人鱼图和链接
- 编辑和重新发送消息、重新生成响应、删除单个消息
- 通过剪贴板或本机共享表以Markdown格式共享对话
- 在对话标题和消息内容之间进行全文搜索
- 自动生成的对话标题
AI模型
- OpenRouter与OAuth PKCE身份验证的集成
- 具有搜索、模态过滤器（文本/图像/音频）和按价格、上下文长度或名称排序的模型选择器
- 使用视觉指示器在对话中切换模型
- 设置默认模型以跳过新对话的选择器
- 每条消息和每条对话的使用情况跟踪（令牌计数、成本明细、推理令牌）
MCP（模型上下文协议）
- 通过Streamable HTTP连接到远程MCP服务器
- 在一次对话中同时使用来自多个MCP服务器的工具
- 浏览并使用服务器提供的带有参数填充的提示模板
- 会话恢复--在应用程序重新启动时保留和重用MCP会话ID
- 采样--在用户批准的情况下处理服务器发起的LLM请求
- 启发式——动态JSON模式形式和基于URL的服务器启发式
- 对经过身份验证的MCP服务器的OAuth支持（RFC 9728/RFC 8414发现）
- 来自长时间运行的MCP操作的实时进度通知
- 调试屏幕，用于检查服务器、查看工具模式和连接状态
媒体
- 从图库、相机或剪贴板粘贴图像（带有型号兼容性检查）
- 在iOS/Android上使用麦克风在线录制音频，或附加音频文件
- MCP工具返回的图像和音频的内联显示，具有全屏缩放图像功能
设置和配置
- 可定制的全局系统提示
- 每条消息可配置的最大工具调用次数（5-100次，或无限制）
- MCP服务器管理——添加、编辑、删除、启用/禁用具有自定义标头的服务器
平台与用户体验
- iOS、Android、macOS、Windows和Linux的原生版本
- 键盘快捷键——按Enter键发送，按Cmd/Ctrl+F键搜索，按Cmd/Ctrl+V键粘贴图像
- 移动设备上的应用内浏览器（SFAfariViewController/Chrome自定义选项卡）
- 在连接到OpenRouter或MCP服务器之前，明确的数据共享同意流
入门指南
先决条件
- Flutter SDK 3.10.7或更高版本
- Dart SDK
- iOS/Android开发环境（适用于移动设备）
安装
- 克隆存储库：
git clone https://github.com/benkaiser/joey-mcp-client.git
cd joey-mcp-client- 安装依赖项：
flutter pub get- 运行应用程序：
flutter run技术栈
- 框架：颤振
- 状态管理：提供商
- 数据库：SQLite（sqflite）
- HTTP客户端：迪奥
- 大语言模型提供商：OpenRouter（OAuth、PKC、SSE流媒体）
- MCP客户端：mcp_dart（流式HTTP）
路线图
- \[x\] MCP资源浏览UI（列出和读取服务器提供的资源）
- \[\]第三方OpenAI兼容API支持（使用您自己的端点作为OpenRouter的替代方案）
- \[x\] 对话导入/导出（JSON备份和还原）
- \[\]模型参数（温度、top_p等）
- \[\]文档和文件附件（PDF、文本文件等）
- \[\]每次对话系统提示
- \[\]主题切换（灯光模式/自定义主题）
- \[\]本地设备工具集成（日历、联系人、短信、电子邮件、提醒、位置、电话）
查找MCP服务器
正在寻找要连接的MCP服务器？查看：
- 远程MCP服务器目录 -可用远程MCP服务器的精选列表
许可证
该项目根据 功能源许可证，1.1版，麻省理工学院未来许可证（FSL-1.1-MIT）.
- 允许非竞争性使用 --您可以出于非竞争性使用的任何目的使用、复制、修改和重新分发本软件
- 两年后，每个版本都会自动转换为标准 MIT许可证 没有任何限制
看 许可证 了解全部细节。