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

uv run -m buid
uv run -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.4.tar.gz (24.8 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.4-py3-none-any.whl (6.1 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: boring_news_mcp-0.5.4.tar.gz
  • Upload date:
  • Size: 24.8 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.4.tar.gz
Algorithm Hash digest
SHA256 092d1784ffa5add9cce5c9544f6a291eca7584d7cdeced790d9299640a7bb8cd
MD5 22f5676a66ccc4332ec19617a3c94c90
BLAKE2b-256 6b7568ecfb7c210bdad3d47c41f59aaa2278430e1d1a3b0c2600f87ca35c2f77

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for boring_news_mcp-0.5.4-py3-none-any.whl
Algorithm Hash digest
SHA256 0301075d99f7d39caf45815f4dba6ca32b2d780fb1ddfe610d06e01e1678a028
MD5 236bd7613647bfaa6f0d92e84ef7c488
BLAKE2b-256 1938a9fda5e8f798695031cbf9518830ff442aac598902537f2056b92ab4f766

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