Mining Daily Report Agent

MCP-based mining daily report generator for mining projects and commodities.

The project provides a command-line agent and three MCP servers:

• mining-news-mcp: search and fetch mining-related news
• mineral-pdf-mcp: extract mineral resource data from PDF reports
• lme-price-mcp: fetch commodity prices and trends

It can run with mock data by default, so no API keys are required for a first local run.

Quick Start

Docker

docker-compose run --rm app python -m agent.cli "给我生成一份关于 Pilbara 锂矿的今日简报"

Local Python

pip install -e ".[dev]"
python -m agent.cli "给我生成一份关于 Pilbara 锂矿的今日简报"

Configuration

Copy .env.example to .env and fill in API keys only when you want to use real providers.

cp .env.example .env

Important variables:

• OPENAI_API_KEY: optional LLM API key
• OPENAI_BASE_URL: OpenAI-compatible API endpoint
• OPENAI_MODEL: model name
• NEWS_PROVIDER: mock or web
• NEWS_API_KEY: optional news provider API key
• PRICE_PROVIDER: mock or public
• PRICE_API_KEY: optional price provider API key

MCP Servers

The repository includes mcp-config.json for MCP clients. The servers run over stdio:

python -m servers.mining_news_mcp.server
python -m servers.mineral_pdf_mcp.server
python -m servers.lme_price_mcp.server

Tests

pytest

Documentation

• RUN.md: detailed run guide
• DESIGN.md: design notes
• examples/: sample inputs and reports