使用说明

项目简介

Pylon 是 OpenAgents 网络的节点软件,它作为一个桌面应用程序,集成了 MCP 服务器、NIP-90 服务提供商和比特币钱包功能。其中 MCP 服务器部分旨在为大型语言模型(LLM)客户端提供标准化的上下文信息和功能支持。Pylon 通过 WebSocket 协议与客户端通信,提供资源访问、工具执行和 Prompt 模板管理等核心 MCP 功能。

主要功能点

  • 资源管理: 允许 LLM 客户端访问和管理本地文件系统中的资源。Pylon 服务器可以列出指定目录下的文件和文件夹,并读取文件内容。
  • 工具集成: 集成了 Ollama,使得 LLM 客户端可以通过 Pylon 服务器调用 Ollama 提供的语言模型进行对话和模型列表查询。这为 LLM 应用提供了强大的外部功能扩展能力。
  • MCP 协议支持: 实现了 Model Context Protocol,确保与兼容 MCP 协议的 LLM 客户端进行标准化的通信和交互。
  • 桌面应用: 作为一个桌面应用程序运行,方便用户本地部署和管理 MCP 服务器。

安装步骤

  1. 克隆仓库:

    git clone https://github.com/OpenAgentsInc/pylon
    cd pylon
  2. 安装 Tauri 环境: 确保已安装 Tauri CLI 和 Rust 开发环境。 如果没有安装,请参考 Tauri 官方文档 完成环境配置。

  3. 安装 Node.js 和包管理器: 确保已安装 Node.js 和 npm 或 yarn 等包管理器。

  4. 安装项目依赖: 在项目根目录下运行以下命令安装前端和 Tauri 依赖:

    npm install  # 或 yarn install
  5. 构建应用程序: 运行 Tauri 构建命令来编译和打包应用程序:

    npm run tauri build  # 或 yarn tauri build

    构建成功后,可执行文件通常位于 'src-tauri/target/release/' 或 'src-tauri/target/debug/' 目录(取决于构建模式)。

  6. 运行应用程序: 找到构建生成的可执行文件并运行。Pylon 应用程序启动后,MCP 服务器将在后台自动运行。

服务器配置

MCP 客户端需要配置连接到 Pylon MCP 服务器才能使用其提供的功能。以下是一个 MCP 客户端配置示例 (JSON 格式):

{
  "serverName": "Pylon MCP Server",
  "command": "/path/to/pylon/executable",  // 【请替换为 Pylon 可执行文件的实际路径】
  "args": [],
  "transport": "websocket",
  "address": "ws://localhost:8080/mcp" // Pylon MCP 服务器默认 WebSocket 地址
}

配置参数说明:

  • 'serverName': MCP 服务器的名称,可以自定义,用于在客户端中标识服务器。
  • 'command': [重要] 请务必将 '/path/to/pylon/executable' 替换为实际构建生成的 Pylon 可执行文件路径。 这个路径指向您在安装步骤中构建的 Pylon 应用程序的可执行文件。
  • 'args': 启动 Pylon 应用程序时需要传递的命令行参数,这里为空数组,表示没有额外的参数。
  • 'transport': 指定 MCP 客户端与服务器通信的传输协议,Pylon MCP 服务器使用 'websocket' 协议。
  • 'address': Pylon MCP 服务器监听 WebSocket 连接的地址。默认配置为 'ws://localhost:8080/mcp',表示服务器在本地主机的 8080 端口的 '/mcp' 路径上接受 WebSocket 连接。

请注意: MCP 客户端需要根据上述配置信息进行设置,特别是要将 'command' 字段更新为 Pylon 可执行文件的实际路径,确保客户端能够正确连接到 Pylon MCP 服务器。

基本使用方法

  1. 启动 Pylon 应用程序: 运行构建好的 Pylon 桌面应用程序。这会自动启动内置的 MCP 服务器。
  2. 配置 MCP 客户端: 在您的 MCP 客户端应用程序中,根据上面提供的服务器配置信息,配置连接到 Pylon MCP 服务器。 确保 'command' 路径配置正确。
  3. 连接和交互: 启动 MCP 客户端,客户端将尝试连接到 Pylon MCP 服务器。连接成功后,您就可以通过客户端向 Pylon 服务器发送 MCP 请求,例如列出资源、读取文件内容、调用 Ollama 模型等,从而利用 Pylon 提供的资源和工具功能。

信息

分类

桌面与硬件