GNews MCP Server

# Mock MCP Documentation Server This repository contains a minimal Model Context Protocol (MCP) server that exposes a single tool: `get_documentation_from_database`. Files added: - `mock_doc_server.py` — FastMCP server exposing `get_documentation_from_database` which returns mocked documentation records. - `requirements.txt` — minimal Python dependency pin for the MCP SDK. Quick start 1. Create a virtual environment and install dependencies: ```bash python -m venv .venv .venv\Scripts\activate # Windows pip install -r requirements.txt ``` 2. Run the server (stdio transport): ```bash python mock_doc_server.py ``` The server listens on STDIO and is intended to be connected to by an MCP client (for example, an MCP client implementation or an MCP-capable host like Claude). If you want a streamable HTTP/SSE server or to mount this server in an ASGI app, see the examples in the MCP Python SDK docs. # Basic project Provide a short description here. ## Setup 1. Create a virtual environment 2. Install dependencies 3. Run your app/tests ## Notes - Update equirements.txt as you add packages. ## GNews MCP Server This workspace includes `gnews_mcp.py` — a FastMCP server that wraps the GNews API Search and Top Headlines endpoints. Quick usage: 1. Install dependencies: ```bash python -m venv .venv .venv\Scripts\activate # Windows pip install -r requirements.txt ``` 2. Set your GNews API key in the environment: ```powershell setx GNEWS_API_KEY "<your_api_key>" # or for current session only: $env:GNEWS_API_KEY = "<your_api_key>" ``` 3. Run the server (streamable HTTP transport): ```bash python gnews_mcp.py ``` 4. The server exposes two tools: - `search(query, max=10, lang=None, country=None)` — GNews Search - `top_headlines(topic=None, max=10, lang=None, country=None)` — Top Headlines See `gnews_mcp.py` for structured response models and usage notes.