Gentoro MCP Server 使用说明

项目简介

Gentoro MCP Server 是一个基于 NodeJS 构建的 MCP 服务器，旨在作为 LLM 客户端（如 Claude）与 Gentoro 服务之间的桥梁。它实现了 Model Context Protocol，使得 LLM 能够通过标准化的 MCP 协议，安全、可扩展地访问 Gentoro 平台托管的工具、数据资源和 Prompt 模板。

主要功能点

MCP 协议兼容: 完全实现了 Model Context Protocol，能够处理来自 LLM 客户端的 MCP 请求，并返回符合 MCP 协议的响应。
Gentoro 服务桥接: 作为 LLM 与 Gentoro 服务的桥梁，将 MCP 请求转换为 Gentoro API 调用，并返回处理结果。
工具和能力访问: 通过 Gentoro Bridge 配置，LLM 客户端可以发现并调用 Gentoro 平台提供的各种工具和能力。
标准化接口: 为 LLM 客户端提供标准化的上下文访问接口，简化了 LLM 应用与外部服务集成的复杂度。
基于 Stdio 传输: 使用 Stdio 作为默认的传输协议，方便与本地运行的 LLM 客户端集成。

安装步骤

安装 Node.js 和 npm: 确保你的系统已安装 Node.js 和 npm (Node 包管理器)。
创建 Gentoro 账户: 访问 Gentoro 官网申请账户并开始使用 Gentoro 服务。
创建 Gentoro API Key: 登录 Gentoro 平台，创建 API Key 用于服务器认证。
定义 Bridge: 使用 Gentoro Studio 定义你的 Bridge，配置所需的工具和数据源。

服务器配置

要将 Gentoro MCP Server 集成到 Claude 客户端，请将以下配置添加到 'claude_desktop_config.json' 文件中。请务必替换 '<your api key>'、'<your bridge uid>' 和 '<url where gentoro is hosted>' 为你在 Gentoro 平台获取的实际信息。

{
    "mcpServers": {
        "gentoro": {
            "command": "npx",
            "args": [
                "-y",
                "@gentoro/mcp-nodejs-server"
            ],
            "env": {
                "GENTORO_API_KEY": "<your api key>",  // 替换为你的 Gentoro API Key
                "GENTORO_BRIDGE_UID": "<your bridge uid>", // 替换为你的 Gentoro Bridge UID
                "GENTORO_BASE_URL": "<url where gentoro is hosted>" // 替换为 Gentoro 服务的基础 URL，例如 "https://gentoro.com"
            }
        }
    }
}

配置参数说明:

'"server name": "gentoro"': 为 MCP 服务器指定一个名称 "gentoro"，在 Claude 客户端中引用此名称。
'"command": "npx"': 指定启动服务器的命令为 'npx'，用于执行 npm 包。
'"args": ["-y", "@gentoro/mcp-nodejs-server"]': 指定 'npx' 的参数，'-y' 表示自动确认安装包，'@gentoro/mcp-nodejs-server' 是要执行的 npm 包名称，即 Gentoro MCP Server。
'"env"': 设置环境变量，用于配置 Gentoro MCP Server 连接 Gentoro 服务所需的认证信息和 Bridge 信息。
- '"GENTORO_API_KEY"': Gentoro API Key，用于认证访问 Gentoro 服务。
- '"GENTORO_BRIDGE_UID"': Gentoro Bridge 的唯一 ID，指定要访问的 Bridge。
- '"GENTORO_BASE_URL"': Gentoro 服务的基础 URL，通常为 Gentoro 平台的域名。

基本使用方法

确保已完成安装步骤和服务器配置。
启动 Claude 客户端。
Claude 客户端将根据 'claude_desktop_config.json' 中的配置自动连接到 Gentoro MCP Server。
现在 Claude 就可以通过 Gentoro MCP Server 访问 Gentoro 平台提供的工具和服务了。你可以通过 Claude 的指令来调用 Gentoro Bridge 中配置的工具，例如查询数据、执行特定功能等。具体可使用的工具和功能取决于你在 Gentoro Bridge 中的配置。

关键词