MsgSkill MCP Server

使用说明(Markdown 格式)

  • 项目简介

    • 本仓库实现了一个基于 MCP(Model Context Protocol)的服务端,用于向 LLM 客户端提供资源访问、工具执行与提示模板渲染等能力。核心实现位于 mcp_server/msgskill_server.py,定义了 MCP 的核心接口,包括列出可用工具(list_tools)和执行工具(call_tool)的能力。
  • 主要功能点

    • 提供 MCP 框架下的工具注册与调用,覆盖新闻抓取、论文获取、RSS、GitHub 趋势等多源数据获取能力。
    • 支持将抓取结果与 Notion 同步的集成(通过配置开启 Notion 同步)。
    • 提供数据预览、定时任务调度、RSSHub 容器管理等辅助功能,作为 MCP 服务器的扩展能力。
    • 服务器通过标准的 JSON-RPC 形式与客户端通信,响应工具调用结果、状态信息等。
  • 安装步骤

    • 确保使用的环境满足仓库依赖要求(通常是 Python 3.8+,在项目中按需安装依赖)。
    • 安装依赖(示例:执行安装命令以安装项目所需依赖)。
    • 启动 MCP 服务器:运行包含 MCP 服务入口的脚本,确保 Python 环境可访问到 mcp_server.msgskill_server 模块。
  • 服务器配置(供 MCP 客户端连接使用) MCP 客户端需要一个描述服务器的配置,用于建立连接并启动与 MCP 服务器的会话。下面给出一份示例配置(以 JSON 形式呈现,普通文本描述字段,便于理解,不作为代码直接执行): { "server_name": "msgskill-mcp", "command": "python3", "args": ["-m", "mcp_server.msgskill_server"] } 说明:

    • server_name:服务器的名称,用于标识该 MCP 服务器实例。
    • command:启动服务器所需的可执行命令,一般为 Python 解释器。
    • args:启动命令的参数,指向实际的 MCP 服务模块入口(模块路径为 mcp_server.msgskill_server)。 注:该配置用于 MCP 客户端在初始化时建立连接并与服务器对话,不需要客户端实现端点访问等具体实现细节。
  • 基本使用

    • 启动后,LLM 客户端通过 MCP 协议向服务器发起请求,请求类型包括读取资源、调用工具、获取提示等。
    • 客户端可通过 JSON-RPC 风格的请求与服务器交互,服务器返回相应的 JSON-RPC 响应。
    • 开发者可通过添加/修改 mcp_server/msgskill_server.py 中的工具实现,扩展 MCP 服务的能力。
  • 重要提示

    • MCP 服务器的能力与具体工具实现紧密相关,若要扩展功能,请在 mcp_server/msgskill_server.py 的注册工具处添加新的 Tool 与输入输出描述。
    • 与 Notion 的集成、RSSHub 容器管理等功能属于可选扩展,请在配置文件中按需开启。

服务器信息