FinanceNews

FinanceNews MCP is a server that provides real-time financial news search capabilities to AI assistants through the MCP protocol. It exposes a single tool named get_financial_news, which accepts a query string and returns relevant financial news articles sourced from Finnhub (with actual API data when keys are configured) and related metadata. To use it, run the server, then configure your MCP client to point to the server's MCP endpoint (typically /mcp) with a suitable timeout. The client can invoke get_financial_news by sending an MCP-compatible request containing the tool name and arguments, for example a query like 'Tesla stock earnings'. You can also configure HTTP headers to pass API keys or tenant information if needed. The integration examples show Claude Desktop and other MCP clients capable of streaming HTTP MCP endpoints with optional headers for authentication.

Prerequisites:

• Node.js 18.0.0 or higher
• npm or yarn

Install from npm (recommended for quick start):

1. Install globally (optional): npm install -g financenews-mcp

2. Start from npm (from source after building): git clone https://github.com/guangxiangdebizi/FinanceNews-MCP.git cd FinanceNews-MCP npm install npm run build npm run start:http

Install from source (full build):

1. Clone the repository git clone https://github.com/guangxiangdebizi/FinanceNews-MCP.git cd FinanceNews-MCP

2. Install dependencies npm install

3. Build the project npm run build

4. Run the server (development or production)

   • Development: npm run dev
   • Production: npm run start:http

Note: The MCP server exposes the endpoint at http://localhost:3000/mcp by default. Adjust the PORT via environment variables if needed.

Tips and common considerations:

• Ensure you have a valid Finnhub API key if you plan to fetch real-time news data. Configure FINNHUB_API_KEY in the environment or pass it via request headers as described in the README.
• Environment variables control port, rate limiting, caching, and log level. Typical defaults are PORT=3000, RATE_LIMIT_WINDOW_MS=900000, RATE_LIMIT_MAX_REQUESTS=100, CACHE_TTL_SECONDS=300, LOG_LEVEL=info.
• If you interrupt the server, use npm run start:http again or npm run dev for development hot-reload.
• When deploying with Docker or PM2, ensure the build artifacts (build/index.js) are present or compiled in the deployment image.
• The server uses a real data source (Finnhub) when API keys are configured; without keys it will clearly indicate missing API configuration and guide on setup.