使用说明内容(Markdown 格式)
项目简介
该仓库包含一个使用 FastMCP 库实现的 MCP 服务器(Python 版本),注册了以下工具供 LLM 客户端通过 JSON-RPC 调用:
- news_start_page:提供新闻起始页/RSS 数据
- search:基于嵌入与向量搜索的新闻检索
- latest_on:基于查询的最新相关内容检索
- retrieve_article_full_text:根据 URL 获取文章全文内容
服务器通过不同传输方式(如 streamable-http)与客户端通信,负责会话管理与能力声明,便于将外部数据源整合进 LLM 尝试生成的上下文中。
主要功能点
- 注册并暴露工具:news_start_page、search、latest_on、retrieve_article_full_text
- 通过 MCP 的 JSON-RPC 规范接收请求并返回响应
- 支持多种传输协议(如 streamable-http),实现与 LLM 的无缝对接
- 依赖外部数据源与服务(RSS 源、Web 请求、文本检索接口、文章全文提取服务)
安装与运行步骤
- 环境要求:Python 3.x、pip
- 安装依赖(示例,实际请参考项目需求的依赖清单):pip install fastmcp requests
- 启动服务器(在仓库根目录执行,基于脚本路径请自行调整):
- 运行命令:python3 -u python/mcp-server.py
- 服务器将以 News Desk 为服务名称,监听 streamable-http 传输,供 MCP 客户端连接使用
服务器配置(JSON,供 MCP 客户端解析)
{ "server_name": "News Desk MCP Server", "command": "python3", "args": ["-u", "python/mcp-server.py"], "transport": "streamable-http", "host": "0.0.0.0", "notes": "启动 MCP 服务器,提供四个工具:news_start_page、search、latest_on、retrieve_article_full_text。客户端无需关注实现细节,仅根据服务器暴露的工具进行调用。" }
基本使用方法
- 启动服务器后,MCP 客户端可通过 JSON-RPC 调用注册的工具
- 使用 news_start_page 获取新闻起始页
- 使用 search 根据查询关键词在新闻中检索
- 使用 latest_on 获取基于查询的最新内容
- 使用 retrieve_article_full_text 传入文章 URL 获取全文内容及元数据
运行与调试要点
- 确保网络访问外部 RSS/网页接口正常,所需依赖服务可用
- 若需要调整传输协议,请参考 FastMCP 的文档及代码注释
- 监控日志输出以排查请求处理、工具执行或网络请求中的错误
进一步扩展
- 未来可扩展资源(Resources)与提示模板(Prompts)支持,以更完整地符合 MCP 定义
- 增加对多语言、权限控制、会话上下文的支持,提升安全性与可扩展性
信息
分类
AI与计算