使用说明内容(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与计算