项目简介

'openrouter-mcp-server' 是一个基于 Model Context Protocol (MCP) 构建的服务器实现。它的核心功能是作为大语言模型 (LLM) 客户端与 OpenRouter 平台之间的桥梁,以标准化的方式向 LLM 客户端提供 OpenRouter 的聊天补全服务。它使得 LLM 应用能够轻松地利用 OpenRouter 上的多种模型进行高级对话交互。

主要功能点

  • OpenRouter 聊天补全: 提供了一个名为 'user-chat-completion' 的工具。LLM 客户端可以通过调用这个工具,向 OpenRouter 发送消息并获取模型的聊天补全响应。
  • MCP 协议支持: 完全遵循 MCP 协议,确保与所有兼容 MCP 的 LLM 客户端进行稳定、高效的通信和交互。
  • 统一的LLM上下文服务: 作为 MCP 服务器,它为 LLM 提供了获取外部功能和管理上下文的能力,从而扩展了 LLM 的应用范围。

安装步骤

在您的系统上运行此 MCP 服务器需要以下几个简单步骤:

  1. 准备构建环境: 确保您的计算机已安装 Java 开发工具包 (JDK) 和构建工具 Gradle。
  2. 获取项目代码: 从 GitHub 克隆 'openrouter-mcp-server' 仓库到您的本地目录。
  3. 执行构建命令: 打开终端或命令行界面,进入您克隆的仓库根目录,然后运行以下命令:
    ./gradlew installDist
    此命令会编译项目并生成可执行文件。
  4. 查找可执行文件: 构建成功后,您可以在 'build/install/openrouter-mcp-server/bin' 目录下找到生成的服务器可执行文件。

服务器配置

MCP 服务器需要由 MCP 客户端来启动和管理。以下是一个典型的 MCP 客户端配置示例,用于连接 'openrouter-mcp-server'。您需要将以下 JSON 配置片段添加到您的 MCP 客户端的配置文件中:

{
  "mcpServers": {
    "openrouter": {
      "command": "<openrouter-mcp-server 可执行文件的绝对路径>",
      "args": [],
      "env": {
        "OPENROUTER_API_KEY": "<您的 OpenRouter API 密钥>"
      }
    }
  }
}

配置项说明:

  • '"openrouter"': 这是您为该 MCP 服务器实例自定义的名称,MCP 客户端将通过这个名称来识别和连接服务器。
  • '"command"': 重要!请将 '<openrouter-mcp-server 可执行文件的绝对路径>' 替换为您在安装步骤中找到的服务器可执行文件的完整路径。例如:'/home/user/my-mcp-servers/openrouter-mcp-server/build/install/openrouter-mcp-server/bin/openrouter-mcp-server'。
  • '"args"': 这是一个用于向服务器传递启动参数的列表。目前为空,表示无需额外参数。
  • '"env"': 这是一个包含环境变量的配置项。
    • '"OPENROUTER_API_KEY"': 重要!请将 '<您的 OpenRouter API 密钥>' 替换为您的实际 OpenRouter API 密钥。这是服务器连接 OpenRouter 服务所必需的认证凭证。

基本使用方法

当您的 MCP 客户端通过上述配置成功启动 'openrouter-mcp-server' 后,LLM 就可以开始利用它提供的功能了。LLM 可以通过向 MCP 服务器发出请求,调用服务器中注册的 'user-chat-completion' 工具。在调用时,LLM 需要提供OpenRouter模型名称和用户的消息内容,服务器会将这些信息传递给 OpenRouter API,并将返回的聊天补全结果回传给 LLM 客户端。

信息

分类

AI与计算