Vibrant Frog MCP

🐸 活力蛙

一个功能强大的macOS AI聊天应用程序，集成了模型上下文协议（MCP）

VibrantFrog为您的Mac带来AI驱动的对话，完全支持MCP工具调用，允许AI模型与外部服务交互，搜索您的照片，并执行自定义工具。

演示

VibrantFrog Demo *人工智能驱动的照片搜索正在进行中——提问，用缩略图获取结果*

截图

AI聊天与照片智能

VibrantFrog AI Chat *聊天界面显示带有自然语言查询和缩略图结果的照片搜索*

MCP服务器管理

MCP Server Configuration *连接到MCP服务器并管理可用工具*

提示模板

Prompt Template Editor *使用变量替换创建和自定义提示模板*

开发者工具

Direct Tool Calling *直接测试和调试MCP工具调用*

对话历史

Conversation History *使用智能命名自动保存对话*

特性

🤖 AI聊天工具调用

• 由Ollama提供支持的原生macOS聊天界面
• 对工具调用的完全MCP（模型上下文协议）支持
• 支持多种型号（Mistral、Llama等）
• 持续的对话历史
• 带变量替换的智能系统提示模板

🔧 MCP集成

• 基于HTTP的MCP服务器连接
• 自定义MCP服务器配置
• 支持stdio和HTTP传输
• 动态工具发现和执行
• 内置AWS MCP服务器支持
• 实时工具调用可视化

📝 及时管理

• 可定制的提示模板
• 变量替换({{TOOLS}}, {{MCP_SERVER_NAME}})
• 不同用例的模板库
• AWS、照片搜索和一般帮助的默认模板

💬 对话管理

• 完整对话历史
• 具有状态持久性的多标签支持
• 照片附件支持
• 缩略图生成和显示
• 对话搜索和过滤

🛠️ 开发人员功能

• 用于测试的直接工具调用接口
• MCP服务器管理UI
• 使用AI描述的照片库索引
• 基于嵌入的矢量搜索
• 用于调试的全面日志记录

需求

• macOS 14.0（索诺玛）或更高版本
• Xcode 15.0或更高版本
• 奥拉玛 本地安装
• 至少一个Ollama模型被拉动（例如。， mistral-nemo:latest)

安装

1.下载VibrantFrog

从下载最新版本 :

• 活力蛙-1.00.dmg （推荐）-拖动到应用程序
• VibrantFrog-v1.00.zip -提取并复制到应用程序

🔒 首次发布安全说明

VibrantFrog已经过代码签名，但尚未经过苹果公司的公证。首次启动时，您需要：

选项1：右键单击“方法”

1. 打开“应用程序”文件夹
2. 右击 （或点击控制按钮）在VibrantFrog.app上
3. 选择“打开”
4. 在安全对话框中单击“打开”
5. 未来的发射工作正常

选项2：终端命令

xattr -cr /Applications/VibrantFrog.app

这是一次性安全确认。VibrantFrog是100%开源的，你可以自己检查代码！

2.安装Olama

# Install Ollama
brew install ollama

# Start Ollama service
ollama serve

# Pull a model with good function calling support
ollama pull mistral-nemo:latest

3.从源代码构建（可选）

如果您更喜欢从源代码构建：

# Clone the repository
git clone https://github.com/SpiderInk/VibrantFrogMCP.git
cd VibrantFrogMCP

# Open in Xcode
open VibrantFrogApp/VibrantFrog.xcodeproj

# Build and run (⌘R)

3.设置照片搜索MCP服务器

VibrantFrog包括一个强大的 Python MCP服务器 用于搜索您的Apple照片库。

📖 完整的MCP服务器设置指南 -VibrantFrog应用程序和Claude Desktop的详细说明

快速设置：

安装Python依赖项

cd /path/to/VibrantFrogMCP
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

运行MCP服务器

选项A：手动启动服务器（HTTP模式）

python3 vibrant_frog_mcp.py --transport http

服务器将于启动 http://127.0.0.1:5050/mcp

选项B：与克劳德桌面（stdio模式）一起使用

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "vibrantfrog-photos": {
      "command": "python3",
      "args": [
        "/path/to/VibrantFrogMCP/vibrant_frog_mcp.py"
      ]
    }
  }
}

在VibrantFrog中配置

1. 内置的“VibrantFrog Photos”服务器已预先配置
2. 确保Python服务器正在运行(python3 vibrant_frog_mcp.py --transport http)
3. 转到“MCP服务器”选项卡，验证服务器是否显示为“已连接”（绿色指示灯）
4. 点击“刷新”以加载可用工具

可用的照片工具：

• search_photos -使用自然语言搜索照片
• get_photo -通过UUID检索特定照片
• create_album -创建新的Apple照片相册
• add_photos_to_album -将照片添加到相册
• list_albums -列出您的所有相册

4.配置其他MCP服务器（可选）

AWS知识库：

URL: https://knowledge-mcp.global.api.aws
Path: (leave empty)

自定义MCP服务器： 通过应用程序中的“MCP服务器”选项卡添加自己的MCP服务器。

快速开始

基本聊天

1. 推出VibrantFrog
2. 从下拉列表中选择一个型号（推荐 mistral-nemo:latest)
3. 开始聊天！

使用工具

1. 转到“MCP服务器”选项卡
2. 添加MCP服务器（或使用内置的AWS服务器）
3. 返回“AI聊天”选项卡
4. 选择MCP服务器和提示模板
5. 提出需要使用工具的问题：

- *“AWS提供哪些服务？”* - *“搜索有关S3的文档”*

自定义提示

1. 导航到“提示”选项卡
2. 创建新模板或编辑现有模板
3. 使用变量：

- {{TOOLS}} -替换为可用的工具说明 - {{MCP_SERVER_NAME}} -替换为所选服务器名称

1. 在AI聊天中选择您的模板

建筑

VibrantFrog采用现代SwiftUI构建，遵循简洁的架构原则：

VibrantFrog/
├── Models/              # Data models (Conversation, Photo, PromptTemplate)
├── Views/               # SwiftUI views
│   ├── AIChatView      # Main chat interface
│   ├── MCPManagementView   # MCP server configuration
│   ├── PromptTemplatesView # Template management
│   └── ...
├── Services/            # Business logic layer
│   ├── OllamaService   # Ollama API integration
│   ├── MCPClientHTTP   # MCP protocol client
│   ├── ConversationStore   # Conversation persistence
│   └── ...
└── VibrantFrogApp.swift # App entry point

关键技术

• SwiftUI -现代声明式UI框架
• 合并 -响应式编程
• URL会话 -HTTP网络
• 用户默认值 -设置持久性
• 照片框架 -照片库访问
• 愿景框架 -AI图像分析

MCP协议支持

VibrantFrog实现 模型上下文协议 规范：

• ✅ initialize -服务器握手
• ✅ tools/list -发现可用工具
• ✅ tools/call -执行工具功能
• ✅ HTTP传输层
• ✅ 标准传输层（规划）
• ✅ 自定义端点路径

配置

模型选择

模型是从您当地的Ollama实例中自动发现的。该应用程序会按标签记住您上次选择的型号。

工具调用的推荐型号：

• mistral-nemo:latest -出色的功能调用
• llama3.2:latest -总体性能良好
• mistral:latest -快速且有能力

系统提示

模板支持变量替换：

You are a helpful AI assistant with access to these tools:

{{TOOLS}}

You are connected to: {{MCP_SERVER_NAME}}

Use tools when needed to answer user questions accurately.

发展

从源头构建

cd VibrantFrogApp
xcodebuild -scheme VibrantFrog -configuration Debug build

运行测试

xcodebuild -scheme VibrantFrog -configuration Debug test

代码风格

• Swift 5.9+功能
• SwiftUI生命周期
• 现代异步/等待模式
• 全面的错误处理
• 调试详细日志记录

故障排除

Ollama连接问题

问题： “Ollama服务不可用”

解决方案：

# Check if Ollama is running
curl http://localhost:11434/api/tags

# Start Ollama if needed
ollama serve

工具调用不起作用

问题： 模型在第一次请求时不使用工具

解决方案：

• 确保您正在使用 mistral-nemo:latest 或另一种具有良好函数调用支持的模型
• 该应用程序在启动时自动“启动”模型（最新版本）
• 检查您的MCP服务器是否已连接（绿色指示灯）

模型不持久

问题： 切换选项卡时所选模型重置

解决方案： 这在最近的更新中得到了修复。确保您拥有最新版本。

贡献

欢迎投稿！请看 贡献.md 作为指导方针。

开发设置

1. 分叉存储库
2. 创建要素分支(git checkout -b feature/amazing-feature)
3. 提交您的更改(git commit -m 'Add amazing feature')
4. 推到分支(git push origin feature/amazing-feature)
5. 打开拉取请求

路线图

• \[\]通过跨平台Swift支持Windows和Linux
• \[\]流媒体响应
• \[\]多模式输入（语音、图像）
• \[\]自定义MCP服务器的插件系统
• \[\]对话的云同步
• \[\]导出对话（Markdown、PDF）
• \[\]暗模式优化
• \[\]自定义模型参数（温度、top-p等）

许可证

VibrantFrog是在MIT许可证下发布的。看 许可证 了解详情。

致谢

• 建于 奥拉玛 用于本地LLM推理
• 实施 模型上下文协议
• 灵感来自Claude Desktop和MCP生态系统

支持

• 问题：
• 讨论：
• 网站： 蜘蛛网 或 放弃.ai

______________________________________________________________________

由...制作❤️ SpiderInk

*将AI带到指尖，一次一只青蛙* 🐸