other

JNews▌

by juhemcp

Discover JNews, a lightweight Python FastAPI server using uv for dependencies and GitHub Actions for CI/CD. Ideal for Fa

Lightweight Python FastAPI server implementation for streamlined server-side interactions, using modern tooling like uv for dependency management and GitHub Actions for automated testing and deployment.

github stars

★ 0

GitHub npm

Modern uv dependency managementGitHub Actions integration

best for

/ Python developers building web APIs
/ Teams needing automated CI/CD pipelines
/ Projects requiring lightweight server solutions

capabilities

/ Run FastAPI server operations
/ Manage dependencies with uv tooling
/ Execute automated testing workflows
/ Deploy via GitHub Actions
/ Handle server-side HTTP requests
/ Process API endpoints

what it does

A lightweight FastAPI server implementation that provides streamlined server-side interactions with modern Python tooling and automated deployment.

about

JNews is a community-built MCP server published by juhemcp that provides AI assistants with tools and capabilities via the Model Context Protocol. Discover JNews, a lightweight Python FastAPI server using uv for dependencies and GitHub Actions for CI/CD. Ideal for Fa It is categorized under other.

how to install

You can install JNews in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.

license

MIT

JNews is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.

readme

Juhe News MCP Server

一个提供新闻头条信息功能的模型上下文协议（Model Context Protocol）服务器。该服务器使大型语言模型（LLMs）能够获取当前最新的热点新闻头条（包括：推荐、国内、科技、体育等类型）及详细内容信息。

Components

Tools

服务器实现了两个工具:

get_news_list: 根据新闻类型获取今日热点新闻头条
- 需要传入 "type"（新闻类型）作为选填的字符串参数。

async def get_news_list(type: str = "top", page: int = 1, page_size: int = 20) -> list[types.TextContent | types.ImageContent | types.EmbeddedResource]:

get_news_content: 根据新闻类型获取今日热点新闻头条
- 需要传入 "uniquekey"（新闻id）作为必须的字符串参数。

async def get_news_content(uniquekey: str) -> list[types.TextContent | types.ImageContent | types.EmbeddedResource]:

Install

This server requires Python 3.10 or higher. Install dependencies using uv (recommended) or pip

Using uv (recommended)

When using uv no specific installation is needed. We will use uvx to directly run jnews-mcp-server.

uvx jnews-mcp-server

Using PIP

Alternatively you can install jnews-mcp-server via pip:

pip install jnews-mcp-server

After installation, you can run it as a script using:

python -m jnews_mcp_server

Configuration

Environment Variables

JUHE_NEWS_API_KEY: 聚合数据的新闻头条API密钥。获取：https://www.juhe.cn/docs/api/id/235

JUHE_NEWS_API_KEY=your_api_key

Claude Desktop

On MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json

<details> <summary>Using uvx</summary>

"mcpServers": {
  "jnews-mcp-server": {
    "command": "uvx",
    "args": [
      "jnews-mcp-server"
    ],
    "env": {
      "JUHE_NEWS_API_KEY": "your_api_key"
    }
  }
}

</details> <details> <summary>Using pip installation</summary>

"mcpServers": {
  "jnews-mcp-server": {
    "command": "python",
    "args": [
      "-m",
      "jnews_mcp_server"
    ],
    "env": {
      "JUHE_NEWS_API_KEY": "your_api_key"
    }
  }
}

</details>

Debugging

You can use the MCP inspector to debug the server. For uvx installations:

npx @modelcontextprotocol/inspector uvx jnews-mcp-server

Or if you've installed the package in a specific directory or are developing on it:

cd path/to/servers/src/jnews-mcp-server
npx @modelcontextprotocol/inspector uv run jnews-mcp-server

Examples of Questions for Cline

"今日有哪些热点新闻?"
"当前体育热点头条?"
"第5条新闻的详细内容"