项目简介

本项目是一个基于 Model Context Protocol (MCP) 的服务器实现,专注于提供圣安东尼奥马刺队 (San Antonio Spurs) 相关的博客文章信息。它从 "Pounding The Rock" 博客抓取内容,并通过 MCP 协议向客户端提供结构化的球队新闻、比赛结果、球员信息等。

主要功能点

  • 资源 (Resources):

    • 'articles://latest': 获取最新的博客文章列表(标题、发布日期、链接、摘要)。
    • 'articles://{article_id}': 根据文章ID获取特定文章的完整内容。
    • 'gameresults://recent': 获取近期圣安东尼奥马刺队的比赛结果(日期、对手、比分、胜负、主客场)。
    • 'players://list': 获取近期文章中提到的马刺队球员列表。
  • 工具 (Tools):

    • 'get_player_info(player_name: str)': 获取指定球员的详细信息,包括球员数据和近期文章提及。
    • 'get_recent_results()': 获取近期圣安东尼奥马刺队的比赛结果,以结构化文本形式返回。
    • 'search_articles(keyword: str)': 搜索包含特定关键词的博客文章。
  • Prompt 模板 (Prompts):

    • 'generate_player_comparison(player1: str, player2: str)': 生成一个用于比较两名球员表现的 Prompt。
    • 'generate_team_news_request(days: int = 7)': 生成一个用于请求过去指定天数内球队新闻摘要的 Prompt。
    • 'generate_nba_news_request()': 生成一个用于请求NBA官网相关马刺队新闻的 Prompt。

安装步骤

  1. 安装 Python 3: 确保您的系统已安装 Python 3 环境。
  2. 安装 'fastmcp' 库: 使用 pip 安装项目依赖的 'fastmcp' 库。
    pip install fastmcp
  3. 下载代码: 从 GitHub 仓库下载 'pounding_the_rock.py' 文件。

服务器配置

MCP 客户端需要配置以下 JSON 信息以连接到此服务器:

{
  "server_name": "spurs-blog-mcp-server",
  "command": "python",
  "args": [
    "pounding_the_rock.py"
  ]
}

配置参数说明:

  • 'server_name': 服务器名称,可以自定义,用于在客户端标识服务器。
  • 'command': 启动服务器的命令,这里使用 'python' 解释器。
  • 'args': 启动命令的参数,这里指定了服务器脚本 'pounding_the_rock.py'。

基本使用方法

  1. 启动 MCP 服务器: 在包含 'pounding_the_rock.py' 文件的目录下,使用 MCP 客户端配置中提供的命令启动服务器。通常客户端会自动完成启动。

  2. 在 MCP 客户端中访问资源: 客户端可以使用 MCP 协议请求访问服务器提供的资源,例如:

    • 请求 'articles://latest' 资源以获取最新文章列表。
    • 请求 'gameresults://recent' 资源以获取近期比赛结果。
  3. 在 MCP 客户端中调用工具: 客户端可以调用服务器提供的工具来执行特定功能,例如:

    • 调用 'get_player_info' 工具并传入球员姓名参数,以获取球员信息。
    • 调用 'search_articles' 工具并传入关键词参数,以搜索相关文章。
  4. 使用 Prompt 模板: 客户端可以调用服务器提供的 Prompt 模板,并根据需要传入参数,以生成用于 LLM 交互的 Prompt。

通过 MCP 客户端,您可以方便地获取圣安东尼奥马刺队的最新博客资讯,并利用提供的工具和 Prompt 模板进行更深入的信息探索和分析。

信息

分类

网页与API