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 容器管理等功能属于可选扩展,请在配置文件中按需开启。