JustOneAPI MCP 服务端

关键词

JustOneAPI上下文服务工具执行原始JSON响应JSON-RPC

使用说明内容（Markdown格式）

  • 项目简介

    • 这是一个基于 MCP（Model Context Protocol）的服务器实现，作为后端服务提供对 JustOneAPI 的“工具”与“信息源”的访问能力。服务器通过 JSON-RPC 风格的 MCP 协议与 MCP 客户端通信，注册并实现具体工具，向客户端提供上下文数据与外部功能调用入口。
    • 关键点：暴露工具、处理认证与错误、返回原始上游 JSON、支持多种传输（此实现使用 Stdio 传输以兼容 Claude Desktop 等 MCP 主机）。

  • 主要功能点

    • 暴露 JustOneAPI 的工具，例如 unified_search_v1（统一跨平台搜索）与 kuaishou_search_video_v2（快手视频搜索），并确保返回的都是原始上游 JSON 数据。
    • 认证与错误处理：通过 JUSTONEAPI_TOKEN 进行认证，错误从 upstream 映射为稳定的 MCP 错误码，提供友好的错误信息。
    • 数据保真：上游响应以原始 JSON 形式返回，服务器不对字段进行解析或重新结构化，确保数据的可追溯性与兼容性。
    • 传输与兼容性：实现基于 MCP 的服务器端接口，使用 StdioServerTransport 作为传输通道，兼容不同的 MCP 主机（如 Claude Desktop）。
    • 配置灵活性：支持通过环境变量设置 token、超时、重试等运行时行为。

  • 安装步骤

    • 安装 Node.js 环境（推荐使用 Node.js 最新稳定版本）。
    • 下载并安装服务器包或从源码编译构建。
    • 设置 JUSTONEAPI_TOKEN 环境变量（这是访问 JustOneAPI 的认证令牌）。
    • 以本地开发模式运行或全局安装后运行。运行方式示例包括通过 npx 启动、全局安装后直接启动，或在本地开发环境中直接执行打包后的入口文件。

  • 服务器配置（MCP 客户端需要的配置信息）

    • 配置示例 1（推荐：npx 启动）： server name: justoneapi command: npx args: ["-y", "justoneapi-mcp"] env: { "JUSTONEAPI_TOKEN": "your_actual_token_here" } 注释：这是用于 Claude Desktop 等 MCP 客户端的最简单接入方式，客户端仅需要读取该配置中的启动命令与参数即可启动并连接到 MCP 服务器。
    • 配置示例 2（全局安装后启动）： server name: justoneapi command: justoneapi-mcp args: [] env: { "JUSTONEAPI_TOKEN": "your_actual_token_here" } 注释：如果你选择全局安装 justoneapi-mcp，只需在环境中设置令牌即可通过 MCP 客户端连接。
    • 配置示例 3（本地开发环境）： server name: justoneapi command: node args: ["/absolute/path/to/justoneapi-mcp/dist/index.js"] env: { "JUSTONEAPI_TOKEN": "your_actual_token_here" } 注释：在本地开发时，可通过直接执行打包后的入口文件来启动 MCP 服务器。

  • 基本使用方法

    • 启动后，在 MCP 主机（如 Claude Desktop）中验证可用工具：
      • 读取可用工具列表，应该能看到 unified_search_v1 与 kuaishou_search_video_v2 等。
    • 使用示例（对话中调用工具）：
      • 使用 unified_search_v1 进行跨平台关键字搜索，返回的是原始上游 JSON。
      • 使用 kuaishou_search_video_v2 按关键词搜索视频，同样返回原始 JSON。
    • 常见运维
      • 启动前确保 JUSTONEAPI_TOKEN 设置正确，否则服务器启动会失败并给出 TOKEN 相关错误。
      • 如需调试，可开启 JUSTONEAPI_DEBUG，日志会输出到标准错误输出以避免干扰 MCP 流。

服务器信息

访问项目