Abstracts Explorer MCP Server

使用说明（Markdown 要点）

• 项目简介
  • 这是一个以 MCP 协议为核心的后端服务器实现，旨在以标准化方式向 LLM 客户端提供论文数据资源、可执行的分析工具，以及可定制的提示模板，以实现高效的聚类分析、主题演化、最近发展等功能的上下文服务。
• 主要功能点
  • 资源管理（Resources）：管理论文、元数据、检索结果等可访问的数据资源，供工具和提示模板使用。
  • 工具注册与执行（Tools）：提供一组可在 MCP 客户端调用的分析工具（如聚类分析、主题演化、最近发展等），支持工具注册、调用及结果格式化。
  • 提示模板（Prompts）：定义并渲染用于与 LLM 交互的提示模板，支持不同的对话模式与上下文配置。
  • JSON-RPC 通信：通过 JSON-RPC 规范接收请求并返回 JSON-RPC 响应或通知，便于跨语言、跨实现的互操作性。
  • 会话与能力声明：服务器端维护会话上下文，声明自身能力（资源、工具、模板的可用性和版本等）。
  • 多传输协议：支持 Stdio、SSE、WebSocket 等传输方式，以适配不同的客户端与部署场景。
  • 安全与可扩展：为 LLM 应用提供安全、可扩展的上下文服务框架，便于后续扩展新资源、工具与模板。
• 安装步骤
  • 依赖准备：确保 Python 环境就绪，安装依赖（通常包含 MCP、JSON-RPC、WebSocket 等相关库）。
  • 启动服务：运行命令启动 MCP 服务器，例如通过 Python 模块入口启动 MCP 服务，用以对外提供 JSON-RPC 接口。
  • 客户端配置：MCP 客户端需要通过配置文件/参数告知服务器名称、启动命令和参数等，以便建立连接与交互。下列配置示例仅供理解，不作为代码执行内容。
• 服务器配置（JSON 配置示例，需客户端提供的连接信息）
  • server_name: "abstracts-explorer-mcp"
  • command: "python3 -m abstracts_explorer.mcp_server"
  • args: ["--port", "8000", "--transport", "websocket"]
  • 说明：此配置描述了服务器的启动命令、参数，以及可以使用的传输协议等。实际使用中，客户端会将此信息以 JSON 格式传递给 MCP 客户端管理器，以建立对 MCP 服务器的连接与交互。
• 基本使用方法
  • 启动后，MCP 客户端通过 JSON-RPC 调用服务器提供的资源读取、工具执行、提示获取等能力，服务器返回标准的 JSON-RPC 响应。
  • 客户端可通过不同传输通道（如 WebSocket、SSE、Stdio）与服务器保持实时交互，支持会话切换、能力查询及工具执行结果的上下文灌注。
• 重要提示
  • MCP 客户端需要的并非裸服务器实现，而是对接的客户端，请根据仓库实际提供的 mcp_server 模块与工具进行对接与测试。
  • 以上说明聚焦 MCP 服务器的核心能力与对接逻辑，实际部署请参考具体实现细节与环境配置。