Goose MCP 服务器使用说明

项目简介

Goose 是一个本地运行的开源AI Agent，其核心组件 'goosed' 实现了 MCP (Model Context Protocol) 服务器，旨在为开发者提供一个可扩展的平台，以自动化各种工程任务。Goose MCP 服务器允许用户注册和管理资源、工具和 Prompt 模板，并通过标准的 JSON-RPC 协议与 LLM 客户端进行通信，构建强大的 AI 驱动的应用。

主要功能点

资源管理: 托管和管理各种类型的数据资源，为 LLM 提供上下文信息。
工具注册与执行: 允许注册和执行外部工具，扩展 LLM 的能力边界，例如代码执行、文件系统操作等。
Prompt 模板: 支持自定义 Prompt 模板，灵活控制 LLM 的交互模式。
JSON-RPC 通信: 基于标准 JSON-RPC 协议与客户端进行通信，实现请求-响应和通知机制。
会话管理: 服务器端负责会话管理，支持客户端进行上下文交互。
能力声明: 服务器声明自身提供的资源和工具能力，方便客户端理解和使用。
多种传输协议支持: 支持 Stdio 等传输协议，保证在不同环境下的兼容性。

安装步骤

由于 Goose MCP 服务器 ('goosed') 是 Goose 项目的一部分，您需要先安装 Goose Desktop 应用才能使用 'goosed' 服务器。

下载 Goose Desktop: 访问 Goose GitHub Releases 页面，下载适合您操作系统的 Goose Desktop 版本 (通常为 '.zip' 文件)。
安装 Goose Desktop: 解压下载的 '.zip' 文件，并按照操作系统指示完成 Goose Desktop 应用程序的安装。

安装 Goose Desktop 后，'goosed' 服务器程序通常会被包含在应用程序的资源目录中。

服务器配置 (MCP 客户端配置)

为了让 MCP 客户端连接到 'goosed' 服务器，您需要配置客户端，指定服务器的启动命令和参数。以下是一个示例配置 (JSON 格式)，您需要根据实际情况进行调整：

{
  "serverName": "goose-mcp-server",
  "command": "path/to/goose-desktop/resources/bin/goosed",
  "args": [
    "agent"
  ],
  "説明": "请将 'path/to/goose-desktop/resources/bin/goosed' 替换为 goosed 可执行文件的实际路径。\n该路径取决于 Goose Desktop 的安装位置，通常在应用程序的 'resources/bin' 目录下。\n'agent' 参数指示 goosed 以 agent 模式 (MCP 服务器模式) 启动。"
}

配置参数说明:

'serverName': MCP 服务器的名称，您可以自定义。
'command': 'goosed' 服务器可执行文件的路径。 请务必替换为实际路径。
'args': 启动 'goosed' 服务器的参数。对于 MCP 服务器模式，通常使用 '["agent"]'。
'説明': 参数配置的注释信息，帮助理解每个配置项的含义 (仅供参考，MCP 客户端配置中不需要此项)。

查找 'goosed' 可执行文件路径:

macOS: 通常在解压后的 'Goose.app/Contents/Resources/bin/goosed'。
Windows: 通常在解压后的 'Goose-win32-x64/resources/bin/goosed.exe'。
Linux: 路径可能因安装方式而异，通常在解压目录的 'resources/bin/goosed' 或 '/usr/bin/goosed'。

基本使用方法

启动 Goose Desktop 应用: 安装完成后，启动 Goose Desktop 应用程序。这会自动在后台启动 'goosed' MCP 服务器。
配置 MCP 客户端: 在您的 MCP 客户端应用中，配置服务器连接信息，使用上面提供的 JSON 配置示例，并确保将 'command' 路径更新为 'goosed' 的实际路径。
连接和交互: MCP 客户端配置完成后，即可连接到 'goosed' 服务器，并利用 MCP 协议进行资源访问、工具调用和 Prompt 模板渲染等操作，与 Goose AI Agent 进行交互。

注意: Goose MCP 服务器 ('goosed') 通常在后台运行，并由 Goose Desktop 应用程序管理生命周期。您无需手动单独启动 'goosed' 服务器。您主要需要配置您的 MCP 客户端以连接到由 Goose Desktop 启动的 'goosed' 服务器。

关键词