AskPlex MCP 服务器

关键词

实时检索外部工具集成AI上下文服务跨系统协作微服务化

项目简介

AskPlex MCP 服务器是一个符合 MCP（Model Context Protocol）标准的后端服务，核心职责是：

  • 向 LLM 客户端以标准化的 JSON-RPC 形式提供工具（Tools）和可渲染的提示（Prompts）等能力
  • 注册并执行外部工具，例如实现对外部信息源的查询
  • 通过一个可扩展的服务框架，支持多种传输方式，确保安全、可扩展地提供上下文信息

主要功能点

  • MCP 服务端实现：实现 MCP 的核心请求处理，包括列出工具（ListTools）和调用工具（CallTool）的能力
  • 工具集合：提供 askplex_search、askplex_followup、askplex_status 等工具，分别用于新会话检索、跟进对话、以及状态查询
  • 与外部桥接：通过桥接服务器（HTTP + WebSocket）与 Perplexity 实时检索等外部信息源协同工作
  • 真实的服务器代码：包含一个独立的 MCP 服务器实现，以及用于桥接的服务器、CLI、浏览器扩展等组件的完整代码结构

安装步骤

  • 准备环境
    • Node.js 18 及以上
  • 获取代码
    • 克隆仓库并进入根目录
  • 运行 MCP 服务器
    • 进入 mcp-server 目录，安装依赖并启动
    • 说明：服务器实现使用 MCP 的标准服务器组件，需要在运行时以 MCP 客户端可连接的形式暴露接口
  • 运行桥接和相关组件（可选）
    • 服务器、浏览器扩展、CLI、以及桥接服务器等组件协同工作时需要相互连接
  • 测试
    • 通过 CLI 或 MCP 客户端向服务器发送 ListTools / CallTool 请求，验证工具输出及响应格式

服务器配置（MCP 客户端所需的配置示例说明，非客户端必需信息）

以下是 MCP 客户端在配置时可参考的配置字段信息，具体数值需结合实际部署环境填写。该信息用于帮助 MCP 客户端了解如何启动并连接到 ASKPLEX 的 MCP 服务器。

{ "serverName": "askplex", "command": "node", "args": ["/path/to/askplex/mcp-server/index.js"] }

  • serverName：MCP 服务器的唯一标识，建议与仓库中的服务器名称保持一致，这里设为 askplex
  • command：启动服务器所需的命令，AskPlex 的 MCP 服务器使用 Node.js 启动
  • args：启动命令的参数，指向 mcp-server/index.js 的入口文件（请将 /path/to/ 替换为实际的本地路径） 说明：MCP 客户端不需要此信息来实现功能，但这是一个给客户端的示例配置，帮助其了解如何在本地/远程启动并连接到 MCP 服务器。

基本使用方法

  • 启动 MCP 服务器后，LLM 客户端通过 MCP 接口请求工具列表（ListTools）与调用工具（CallTool）
  • 调用示例（语义层次）：
    • 列出可用工具：客户端向 MCP 服务器发送 ListTools 请求，获取工具清单
    • 调用工具进行检索：使用 askplex_search 进行实时网络检索，返回带来源的答案
    • 跟进问题：使用 askplex_followup，在同一会话中继续提出问题
    • 状态查询：使用 askplex_status 查看当前连接状态和服务器健康信息
  • 注意事项
    • 某些工具可能有较长的超时（如 1-5 分钟），请按工具描述耐心等待结果
    • MCP 服务器通常通过 JSON-RPC 与客户端通信，确保网络与权限配置正确，防火墙允许所用端口

服务器信息

访问项目