ruanyifeng-weekly-mcp

MCP server for searching ruanyf/weekly GitHub issues and returning a Markdown list with summaries.

Features

• Search ruanyf/weekly issues via GitHub Search API
• Keyword overrides that prioritize YouMind related results
• JSON file cache with TTL (default 6 hours)
• Optional GitHub token for higher rate limits
• Streamable HTTP transport at /mcp (port 8113 by default)

Tool

search_weekly(query, limit=5, state="all", category=None, format="markdown") -> Markdown

Parameters:

• query: search keyword
• limit: 1-50
• state: all, open, closed
• category: optional issue title tag
• format: must be markdown

Environment

• SERVER_HOST (default 0.0.0.0)
• SERVER_PORT (default 8113)
• CACHE_DIR (default ./cache)
• CACHE_TTL_SECONDS (default 21600)
• GITHUB_TOKEN (optional)
• LOG_LEVEL (default INFO)
• HTTP_TIMEOUT_SECONDS (default 30)

Run locally

1. Create a virtual environment

python3 -m venv .venv

1. Activate it

source .venv/bin/activate

1. Install dependencies

pip install -r requirements.txt

1. Run the server

python app.py

The server listens on http://127.0.0.1:8113/mcp by default.

Kelivo config (streamableHttp)

{
  "mcpServers": {
    "ruanyifeng-weekly": {
      "name": "ruanyifeng-weekly",
      "type": "streamableHttp",
      "baseUrl": "http://YOUR_HOST:8113/mcp",
      "isActive": true
    }
  }
}

systemd

See deploy/ruanyifeng-weekly-mcp.service and deploy/ruanyifeng-weekly-mcp.env.example.