News-MCP-Server

Danieljoh98/News-MCP-Server

3.2

If you are the rightful owner of News-MCP-Server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The News MCP Server integrates news data with AI analysis to provide comprehensive news analysis and insights.

Tools
3
Resources
0
Prompts
0

📰 News MCP Server

En MCP (Model Context Protocol) server som integrerer nyhetsdata med AI-analyse for å gi omfattende nyhetsanalyse og innsikt.

🌟 Funksjoner

Denne MCP-serveren tilbyr tre hovedverktøy:

  • 📰 get_news: Henter og analyserer nyhetsartikler med AI-genererte sammendrag
  • ⚖️ generate_pros_cons: Lager fordeler/ulemper-analyse basert på nyhetsartikler
  • 📅 build_timeline: Bygger tidslinjer over hendelser fra nyhetskilder

🛠️ Installasjon

Forutsetninger

  • Python 3.13 eller nyere
  • UV package manager (anbefalt) eller pip
  • API-nøkler (se konfigurasjon nedenfor)

1. Klone prosjektet

git clone https://github.com/ditt-brukernavn/news.git
cd news

2. Installer avhengigheter

Med UV:

uv sync

Med pip:

pip install httpx "mcp[cli]" python-dotenv

3. Konfigurer API-nøkler (PÅKREVD)

⚠️ VIKTIG: Dette prosjektet krever API-nøkler som du må skaffe selv.

3.1 Skaff API-nøkler

Du trenger følgende API-nøkler:

NewsAPI (Gratis):

  1. Gå til newsapi.org
  2. Klikk "Get API Key"
  3. Registrer deg med e-post
  4. Kopier din API-nøkkel

Claude API (Betalt):

  1. Gå til console.anthropic.com
  2. Opprett en konto
  3. Gå til "API Keys" i dashboardet
  4. Klikk "Create Key"
  5. Kopier din API-nøkkel
3.2 Opprett .env-fil

Opprett en .env-fil i rotmappen av prosjektet:

touch .env  # Linux/Mac
# eller opprett filen manuelt i Windows

Legg til dine API-nøkler i .env-filen:

NEWS_API_KEY=din_faktiske_newsapi_nøkkel_her
CLAUDE_API_KEY=din_faktiske_claude_api_nøkkel_her

Eksempel:

NEWS_API_KEY=a1b2c3d4e5f6789012345abcdef67890
CLAUDE_API_KEY=sk-ant-api03-AbCdEf1234567890...

🔒 Sikkerhetsnote: .env-filen er allerede lagt til i .gitignore og vil ikke bli lastet opp til GitHub.

🚀 Bruk

Test at alt fungerer

Før du starter serveren, test at API-nøklene fungerer:

python -c "
import os
from dotenv import load_dotenv
load_dotenv()
print('NewsAPI Key:', 'OK' if os.getenv('NEWS_API_KEY') else 'MANGLER')
print('Claude Key:', 'OK' if os.getenv('CLAUDE_API_KEY') else 'MANGLER')
"

Som MCP Server (anbefalt)

  1. Start serveren:
python news.py
  1. Koble til Claude Desktop ved å legge til følgende i din claude_desktop_config.json:
{
  "mcpServers": {
    "news": {
      "command": "python",
      "args": ["C:/full/sti/til/news/news.py"],
      "env": {
        "NEWS_API_KEY": "din_faktiske_newsapi_nøkkel",
        "CLAUDE_API_KEY": "din_faktiske_claude_nøkkel"
      }
    }
  }
}

Alternativt (anbefalt): Bruk .env-filen ved å peke til prosjektmappen:

{
  "mcpServers": {
    "news": {
      "command": "python",
      "args": ["news.py"],
      "cwd": "C:/full/sti/til/news/"
    }
  }
}

Tilgjengelige verktøy i Claude

📰 get_news(topic)

Henter nyhetsartikler om et spesifikt tema og genererer AI-sammendrag.

Eksempel:

Bruk get_news-verktøyet for å finne artikler om "klimaendringer"
⚖️ generate_pros_cons(topic)

Analyserer nyhetsartikler og lager en strukturert fordeler/ulemper-liste.

Eksempel:

Bruk generate_pros_cons-verktøyet for "elbiler" for å se argumenter på begge sider
📅 build_timeline(topic)

Bygger en kronologisk tidslinje basert på nyhetshendeser.

Eksempel:

Bruk build_timeline-verktøyet for "ukraina-krig" for å se hendelsesforløp

📁 Prosjektstruktur

news/
├── .env                 # API-nøkler (MÅ OPPRETTES AV DEG)
├── .gitignore          # Git-ignorerte filer
├── .python-version     # Python versjonsspesifikasjon
├── pyproject.toml      # Prosjektkonfigurasjon og avhengigheter
├── uv.lock            # UV låsefil for reproduserbare builds
├── news.py            # Hovedserverfil
├── news copy.py       # Backup/alternativ implementasjon
├── news_news_detailed_comments.py  # Detaljert kommentert versjon
└── README.md          # Denne filen

🔧 Teknisk oversikt

Avhengigheter

  • httpx: Asynkron HTTP-klient for API-forespørsler
  • mcp[cli]: Model Context Protocol implementasjon
  • python-dotenv: For miljøvariabel-håndtering

API-integrasjoner

  • NewsAPI v2: Henter nyhetsartikler fra tusenvis av kilder
  • Claude 3 Haiku: AI-analyse og sammendrag av innhold

Sikkerhet

  • API-nøkler lagres i .env-fil (ikke versjonskontrollert)
  • HTTPS-forespørsler til alle eksterne API-er
  • Timeout-håndtering for alle nettverksforespørsler

💰 Kostnader

  • NewsAPI: Gratis tier gir 1000 forespørsler per måned
  • Claude API: Betales per token - Haiku er rimeligste modell (~$0.25/1M tokens)

Estimert kostnad for moderat bruk: $5-15 per måned avhengig av aktivitet.

🐛 Feilsøking

Vanlige problemer

  1. "Fant ingen artikler"

    • ✅ Sjekk at NEWS_API_KEY er korrekt satt i .env
    • ✅ Verifiser at API-nøkkelen er gyldig på newsapi.org

  2. "Klarte ikke analysere med Claude"

    • ✅ Sjekk at CLAUDE_API_KEY er korrekt satt i .env
    • ✅ Verifiser at du har kreditt på Anthropic-kontoen din
    • ✅ Test nettverkstilgang til api.anthropic.com

  3. "Server starter ikke"

    • ✅ Kontroller at alle avhengigheter er installert: uv sync
    • ✅ Sjekk at Python 3.13+ er installert: python --version
    • ✅ Verifiser at .env-filen eksisterer og inneholder begge nøklene

  4. "ModuleNotFoundError"

    • ✅ Aktiver virtual environment: .venv\Scripts\activate (Windows) eller source .venv/bin/activate (Linux/Mac)
    • ✅ Installer avhengigheter på nytt

Testing av API-nøkler

Test NewsAPI:

curl -H "Authorization: Bearer DIN_NEWSAPI_NØKKEL" \
  "https://newsapi.org/v2/everything?q=test&pageSize=1"

Test Claude API:

curl -X POST https://api.anthropic.com/v1/messages \
  -H "x-api-key: DIN_CLAUDE_NØKKEL" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-3-haiku-20240307","max_tokens":10,"messages":[{"role":"user","content":"test"}]}'

Logging

For detaljert debugging:

python news.py --verbose

📝 Lisens

Dette prosjektet er utviklet for personlig/utdanningsbruk. Se respektive API-leverandørers vilkår for kommersielle restriksjoner.

🤝 Bidrag

Forbedringsforslag og pull requests er velkommen! Vennligst:

  1. Fork prosjektet
  2. Opprett en feature branch
  3. Commit dine endringer
  4. Push til branchen
  5. Opprett en Pull Request

📞 Support

⚠️ Husk: Du må skaffe dine egne API-nøkler for at dette prosjektet skal fungere!