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.0.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.0-py3-none-any.whl (5.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: boring_news_mcp-0.5.0.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.0.tar.gz
Algorithm Hash digest
SHA256 f96c1e7459d90e965a649e1dd74897c0ae8cda7892048610efe4197c7d4f264f
MD5 f697f6078a8df010a4c5febeffb8a6ca
BLAKE2b-256 1a1772b2a840a63ede9baa614b5338e92f1ea197ea8cdb22ee54c166fc88fd5d

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for boring_news_mcp-0.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 3d9a3cab9f396a496209c21967c7f2f19e21e03cd51d6295fbeb29d92e3932d0
MD5 3c9128150c908d505486a2d41f4ecd1c
BLAKE2b-256 2af7457d45e0b6c2e23b455a6027ce6464f27a766170d5cdbb1d360d62bc3116

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