Skip to main content

MCP (Model Context Protocol) Server for Boring News API

Project description

Boring News MCP Server

A Python server library for interacting with the Boring News API from a MCP (Model Context Protocol) server like Claude Desktop. The website : boring-news.fr

Features

four actions :

  • Fetch articles by date, category, or tags

  • Get articles mentioning specific people

  • Find similar articles based on text content

  • Get article groups and categories

  • Predefined Prompts

    • Daily news (tech and culture focused)
    • Comprehensive daily summaries
    • News highlights
    • Cultural news focus

Quick Start

pip install boring-news-mcp

Exemple of claude Desktop Configuration

{
  "mcpServers": {
    ...      
    "boringnews": {
          "command": "python",
          "args": [
                "-m", 
                "boring_news_mcp"
          ]
      },
    ...
    }
}

API Reference

Articles

  • get_articles_by_date(date: Optional[str], category: Optional[str], tags: Optional[str]) -> str
  • get_articles_by_person(person: str) -> str
  • get_similar_articles(text: str) -> str
  • get_article_groups(date: Optional[str]) -> str
  • get_categories(date: Optional[str]) -> str

News Summaries Prompt

  • daily_news(target_date: str) -> str
  • daily_news_summary(target_date: str) -> str
  • daily_news_highlights(target_date: str) -> str
  • daily_cultural_news(target_date: str) -> str

Requirements

  • Python >= 3.8
  • httpx >= 0.25.0
  • fastmcp >= 0.1.0

License

MIT License

Build

python -m buid
python -m twine upload dist/
rm dist/*

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

boring_news_mcp-0.5.2.tar.gz (24.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

boring_news_mcp-0.5.2-py3-none-any.whl (5.8 kB view details)

Uploaded Python 3

File details

Details for the file boring_news_mcp-0.5.2.tar.gz.

File metadata

  • Download URL: boring_news_mcp-0.5.2.tar.gz
  • Upload date:
  • Size: 24.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.13.2

File hashes

Hashes for boring_news_mcp-0.5.2.tar.gz
Algorithm Hash digest
SHA256 cae41875ff83df6baa549c1aa49ad051104156bf1505555069c3315d8345c87a
MD5 6e1a9216f38d380c95924c7e40bb1f89
BLAKE2b-256 8ad9be9c2cde47d52b85be7de9d4cdc064599ee5795530d5e2d57f331b911b3c

See more details on using hashes here.

File details

Details for the file boring_news_mcp-0.5.2-py3-none-any.whl.

File metadata

File hashes

Hashes for boring_news_mcp-0.5.2-py3-none-any.whl
Algorithm Hash digest
SHA256 688e56aa511dd44be02027b6b195984dfbdc8196ade307a259be83f7a8eaad37
MD5 133ffc35e00ac3b8d685834c2c08b8d3
BLAKE2b-256 2450fac6128d356bf396a88d10db71065cdff743b48b819aa67f2f23fdcf67a3

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page