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

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.1.tar.gz (33.2 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.1-py3-none-any.whl (5.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: boring_news_mcp-0.5.1.tar.gz
  • Upload date:
  • Size: 33.2 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.1.tar.gz
Algorithm Hash digest
SHA256 8aa452882353103ce1ceb513a8357807bda76c8e1dd7d114a7b038bd2fb331c2
MD5 6cc4f2657c7bc47a61716434b638f752
BLAKE2b-256 5f5670a3f90fc468f1962cc6a9dcd2fc83b58be08611d3eb22b66ea26a7d7346

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for boring_news_mcp-0.5.1-py3-none-any.whl
Algorithm Hash digest
SHA256 1c118126d954cb7a87665c8d6c33cd04faf5b2edab2937f49c60d18fbc4f6760
MD5 b01072f4588b4a2e2a0f675a6f585180
BLAKE2b-256 759798e057c75d10d27177411062ac6d6f9bc53d4fac91f6df7f368edccda02d

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