使用说明

项目简介

Botanika Desktop 不仅是一个本地LLM客户端，更集成了MCP服务器功能。这意味着它不仅可以作为客户端连接到其他MCP服务器，自身也能作为一个MCP服务器对外提供服务。该仓库的代码主要侧重于客户端应用，但同时也包含了内置MCP服务器的实现，使其能够托管工具并与支持MCP协议的客户端（例如，它自身也可以作为客户端连接到自身提供的MCP服务）进行交互。

主要功能点

内置MCP服务器: Botanika Desktop 应用程序内部署了MCP服务器，能够托管和管理工具，并通过标准MCP协议与客户端通信。
工具集成: 内置MCP服务器预集成了Google搜索和Spotify工具，允许LLM客户端通过MCP协议调用这些外部功能。
本地化服务: 作为一个桌面应用，Botanika Desktop 提供的MCP服务器是本地运行的，所有数据和处理都在本地完成，保障数据隐私和安全。
SSE传输协议: MCP服务器使用SSE (Server-Sent Events) 作为传输协议，简化了客户端与服务器之间的通信实现。
易于配置: 通过简单的配置，即可启用和使用内置的MCP服务器及其提供的工具。

安装步骤

克隆仓库

git clone https://github.com/targoninc/botanika-desktop
cd botanika-desktop

安装依赖
```
npm install
```
启动开发服务器
```
npm run dev
```
或者，如果需要构建打包后的应用：
```
npm run build
npm run start
```
启动后，Botanika Desktop 应用程序将运行，同时内置的MCP服务器也会在后台启动。

服务器配置

Botanika Desktop 的MCP服务器无需复杂的单独配置，它作为应用的一部分自动启动。对于MCP客户端而言，连接到Botanika Desktop提供的MCP服务器，需要配置服务器的URL。

以下是连接到Botanika Desktop 内置MCP 服务器的 客户端配置信息 (JSON 格式)，请将以下配置填入 MCP客户端 的服务器配置中：

[
  {
    "server name": "Botanika 内置服务器 - Google Search",
    "url": "http://localhost:48678/mcp/sse/google/search"
  },
  {
    "server name": "Botanika 内置服务器 - Spotify",
    "url": "http://localhost:48678/mcp/sse/spotify"
  }
]

配置参数说明:

'"server name"': MCP服务器的名称，可以自定义，方便在客户端界面识别和管理连接。
'"url"': 重要！MCP服务器的SSE端点URL。对于Botanika Desktop 内置的服务器，Google Search 工具的URL为 'http://localhost:48678/mcp/sse/google/search'，Spotify 工具的URL为 'http://localhost:48678/mcp/sse/spotify'。 端口号 '48678' 是默认端口，如果你的Botanika Desktop 应用使用了不同的端口，请相应地修改URL中的端口号。

基本使用方法

启动 Botanika Desktop 应用：按照安装步骤启动应用后，内置MCP服务器即在运行。
配置 MCP 客户端: 在你的MCP客户端中，添加上述提供的服务器配置信息，指定要连接的服务器名称和URL。
在 MCP 客户端中使用工具: 连接成功后，MCP客户端应该能够检测到Botanika Desktop MCP服务器提供的 "Google Search" 和 "Spotify" 工具。在LLM交互过程中，客户端可以指示LLM调用这些工具来执行相应的外部功能，例如进行网页搜索或控制Spotify音乐播放。

注意: 由于Botanika Desktop 主要定位为桌面客户端应用，其内置MCP服务器的目的是为了配合客户端自身的功能，可能不包含完整的、独立部署的MCP服务器的所有特性。但从代码分析来看，它实现了MCP协议的核心服务器功能，可以作为有效的MCP服务器端点使用，特别是用于集成Google搜索和Spotify工具。

关键词

使用说明

信息