【实战】手把手学习写一个MCP服务，获取热榜文章

https://modelcontextprotocol.io/introduction

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

curl -LsSf https://astral.sh/uv/install.sh | sh

pip install mcp

from mcp.server.fastmcp import FastMCPmcp = FastMCP("server name")# 工具声明 需用异步@mcp.tool()async def tool_name(param: int) -> []:    """    注释描述    参数描述    返回描述    """    data = []    return data# 运行服务if __name__ == "__main__":    mcp.run()

import httpxfrom mcp.server.fastmcp import FastMCPmcp = FastMCP("hot articles")JUEJIN_BASE_URL = "https://api.juejin.cn/content_api/v1/content/article_rank?category_id=1&type=hot"USER_AGENT = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/134.0.0.0 Safari/537.36"ARTICLE_BASE_URL = "https://juejin.cn/post/"async def get_juejin_articles_rank():    headers = {        "User-Agent": USER_AGENT,    }    async with httpx.AsyncClient() as client:        try:            response = await client.get(JUEJIN_BASE_URL, headers=headers)            response.raise_for_status()            return response.json()["data"]        except Exception as e:            return Nonedef data_format(data):    article_list = []    for content in data:        article = {            "title": content["content"]["title"],            "url": ARTICLE_BASE_URL + content["content"]["content_id"],            "author": content["author"]["name"]        }        article_list.append(article)    return article_list@mcp.tool()async def mcp_tool_get_juejin_articles_rank(count: int):    """    获取掘金文章    :param count: 控制获取的文章数量    :return: 文章列表    """    data = await get_juejin_articles_rank()    if not data:       return []    data = data_format(data)    if count > len(data):        count = len(data)    return data[:count]if __name__ == "__main__":    mcp.run()

uv run 绝对路径Pathmcp_server.py