Goodnews

Example Usage: MCP Goodnews with Claude Desktop# Requirements

• Cohere API Key
• NewsAPI Key
• Claude Desktop Application
• uv Python Project and Package Manager

Clone mcp-goodnews

git clone https://github.com/VectorInstitute/mcp-goodnews.git

Update Claude Desktop Config to find mcp-goodnews## For Mac/Linux

cd ~/Library/Application\ Support/Claude/config\n\n# Edit the claude_desktop_config.json file
nano claude_desktop_config.json
```\n\n#### For Windows
```bash\n\n# Navigate to the configuration directory
cd %APPDATA%\Claude\config\n\n# Edit the claude_desktop_config.json file
notepad claude_desktop_config.json

And you'll want to add an entry under mcpServers for Goodnews:

{
  "mcpServers": {
    "Goodnews": {
      "command": "/uv",
      "args": ["--directory", "/mcp-goodnews/src/mcp_goodnews", "run", "server.py"],
      "env": {
        "NEWS_API_KEY": "",
        "COHERE_API_KEY": ""
      }
    }
  }
}
```\n\n### Start or Restart Claude Desktop
Claude Desktop will use the updated config to build and run the mcp-goodnews server. If successful, you will see the hammer tool in the bottom-right corner of the chat dialogue window. Clicking the hammer tool icon will bring up a modal that lists available MCP tools. You should see `fetch_list_of_goodnews` listed there.\n\n### Ask Claude for Good News
Example prompts:
- "Show me some good news from today."
- "What positive things happened in the world this week?"
- "Give me uplifting news stories about science."\n\n## How It Works
1. When you request good news, the application queries the NewsAPI for recent articles
2. The Cohere LLM analyzes the sentiment of each article
3. Articles are ranked based on positive sentiment score
4. The top-ranking good news stories are returned to you through Claude