cp-mcp 0.1.0__tar.gz

cp_mcp-0.1.0/.gitignore

@@ -0,0 +1,12 @@
+__pycache__/
+*.pyc
+*.egg-info/
+build/
+dist/
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+.venv/
+venv/
+.env
+.DS_Store

cp_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Eesh Saxena
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

cp_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,142 @@
+Metadata-Version: 2.5
+Name: cp-mcp
+Version: 0.1.0
+Summary: MCP server exposing Codeforces and CodeChef data (ratings, submissions, problems, contests) as tools for any MCP client. No API keys required.
+Project-URL: Homepage, https://github.com/eeshsaxena/cp-mcp
+Project-URL: Repository, https://github.com/eeshsaxena/cp-mcp
+Author: Eesh Saxena
+License: MIT
+License-File: LICENSE
+Keywords: codechef,codeforces,competitive-programming,llm,mcp,model-context-protocol,tools
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.24
+Requires-Dist: mcp<2,>=1.2
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == 'dev'
+Requires-Dist: ruff>=0.5; extra == 'dev'
+Description-Content-Type: text/markdown
+
+# cp-mcp
+
+An [MCP](https://modelcontextprotocol.io) server that gives any LLM assistant live
+access to **Codeforces**, **CodeChef**, and **LeetCode**: ratings, submissions,
+solved-problem stats, practice-problem pickers, daily challenges, upcoming contests,
+and a combined cross-site profile.
+
+- **No API keys, accounts, or registration.** Codeforces comes from its free, open,
+  keyless public API; LeetCode from its public GraphQL endpoint; CodeChef is scraped
+  from public pages (it has no usable API). Nothing to sign up for, nothing to configure.
+- **Model-agnostic.** It speaks MCP over stdio, so it works with any MCP client
+  (Claude Desktop, Cursor, Continue, Cline, LM Studio, ...) and therefore any model
+  behind them, including open-weight ones.
+
+## Tools
+
+| Tool | What it does |
+| --- | --- |
+| `cf_user_info` | Codeforces rating / max rating / rank for one or more handles |
+| `cf_rating_history` | Per-contest rank and rating delta on Codeforces |
+| `cf_recent_submissions` | Recent submissions (problem, verdict, language) |
+| `cf_solved_stats` | Distinct problems solved, counts by rating, top tags |
+| `cf_search_problems` | Search the problemset by tag + rating range |
+| `cf_recommend_problem` | Random practice problem in a rating range, optionally excluding ones a handle already solved |
+| `cf_daily_problems` | A daily practice set of 1-4 problems, chosen deterministically from the date (same all day, refreshes at 00:00 UTC) |
+| `cf_upcoming_contests` | Not-yet-started Codeforces contests, soonest first |
+| `codechef_user_info` | CodeChef rating, stars, highest rating, global + country rank |
+| `codechef_rating_history` | CodeChef rated-contest history |
+| `codechef_upcoming_contests` | Upcoming CodeChef contests |
+| `leetcode_user_info` | LeetCode ranking, reputation, solved by difficulty, contest rating |
+| `leetcode_recent_submissions` | Recent accepted LeetCode submissions |
+| `leetcode_daily_challenge` | Today's official LeetCode daily problem |
+| `leetcode_upcoming_contests` | Upcoming LeetCode weekly/biweekly contests |
+| `all_profiles` | One user across Codeforces + CodeChef + LeetCode in a single call |
+| `daily_challenges` | Today's practice in one call: the Codeforces daily set + LeetCode's daily challenge |
+
+## Install and run
+
+Requires Python 3.10+.
+
+```bash
+# from a checkout
+pip install -e .
+cp-mcp            # runs the stdio server (a client normally launches this for you)
+```
+
+Or run without installing:
+
+```bash
+python -m cp_mcp
+```
+
+## Wire it into a client
+
+The server is launched by your MCP client over stdio. Point the client at either the
+`cp-mcp` console script or `python -m cp_mcp`.
+
+**Claude Desktop** — add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "cp-mcp": {
+      "command": "cp-mcp"
+    }
+  }
+}
+```
+
+If `cp-mcp` isn't on the client's PATH, use the interpreter form instead:
+
+```json
+{
+  "mcpServers": {
+    "cp-mcp": {
+      "command": "python",
+      "args": ["-m", "cp_mcp"]
+    }
+  }
+}
+```
+
+**Any other MCP client** (Cursor, Continue, Cline, LM Studio, an open-weight setup, ...):
+register a stdio server with command `cp-mcp` (or `python -m cp_mcp`). No env vars, no keys.
+
+## Example asks
+
+> "What's tourist's current Codeforces rating and their last 5 submissions?"
+> "Give me an unsolved 1600-rated Codeforces DP problem for handle eeshsaxena."
+> "What are today's daily practice problems?"
+> "Show my CodeChef rating history and the next CodeChef contest."
+> "What's today's LeetCode daily challenge?"
+> "Give me all of today's challenges (Codeforces + LeetCode)."
+> "Pull my profile on all three: Codeforces eeshsaxena, CodeChef eeshsaxena, LeetCode eeshsaxena."
+
+## Notes and limits
+
+- **Codeforces** rate-limits the public API to roughly one request every two seconds;
+  a couple of the tools (`cf_solved_stats`, `cf_recommend_problem` with a handle) pull
+  a user's full submission list, so they take a moment for very active accounts.
+- **CodeChef** has no public API, so those tools scrape public HTML. That is inherently
+  fragile: if CodeChef changes its markup or rate-limits the request, fields degrade to
+  `null` or the tool returns an `{"error": ...}` dict rather than crashing.
+- **LeetCode** uses its public GraphQL endpoint (the same one the website uses). It is
+  keyless but undocumented, so a schema change on LeetCode's side could require updates.
+- This project is not affiliated with Codeforces, CodeChef, or LeetCode. Use it within
+  their terms.
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest          # network is fully mocked; tests run offline
+ruff check .
+```
+
+## License
+
+MIT. See [LICENSE](LICENSE).

cp_mcp-0.1.0/README.md

@@ -0,0 +1,119 @@
+# cp-mcp
+
+An [MCP](https://modelcontextprotocol.io) server that gives any LLM assistant live
+access to **Codeforces**, **CodeChef**, and **LeetCode**: ratings, submissions,
+solved-problem stats, practice-problem pickers, daily challenges, upcoming contests,
+and a combined cross-site profile.
+
+- **No API keys, accounts, or registration.** Codeforces comes from its free, open,
+  keyless public API; LeetCode from its public GraphQL endpoint; CodeChef is scraped
+  from public pages (it has no usable API). Nothing to sign up for, nothing to configure.
+- **Model-agnostic.** It speaks MCP over stdio, so it works with any MCP client
+  (Claude Desktop, Cursor, Continue, Cline, LM Studio, ...) and therefore any model
+  behind them, including open-weight ones.
+
+## Tools
+
+| Tool | What it does |
+| --- | --- |
+| `cf_user_info` | Codeforces rating / max rating / rank for one or more handles |
+| `cf_rating_history` | Per-contest rank and rating delta on Codeforces |
+| `cf_recent_submissions` | Recent submissions (problem, verdict, language) |
+| `cf_solved_stats` | Distinct problems solved, counts by rating, top tags |
+| `cf_search_problems` | Search the problemset by tag + rating range |
+| `cf_recommend_problem` | Random practice problem in a rating range, optionally excluding ones a handle already solved |
+| `cf_daily_problems` | A daily practice set of 1-4 problems, chosen deterministically from the date (same all day, refreshes at 00:00 UTC) |
+| `cf_upcoming_contests` | Not-yet-started Codeforces contests, soonest first |
+| `codechef_user_info` | CodeChef rating, stars, highest rating, global + country rank |
+| `codechef_rating_history` | CodeChef rated-contest history |
+| `codechef_upcoming_contests` | Upcoming CodeChef contests |
+| `leetcode_user_info` | LeetCode ranking, reputation, solved by difficulty, contest rating |
+| `leetcode_recent_submissions` | Recent accepted LeetCode submissions |
+| `leetcode_daily_challenge` | Today's official LeetCode daily problem |
+| `leetcode_upcoming_contests` | Upcoming LeetCode weekly/biweekly contests |
+| `all_profiles` | One user across Codeforces + CodeChef + LeetCode in a single call |
+| `daily_challenges` | Today's practice in one call: the Codeforces daily set + LeetCode's daily challenge |
+
+## Install and run
+
+Requires Python 3.10+.
+
+```bash
+# from a checkout
+pip install -e .
+cp-mcp            # runs the stdio server (a client normally launches this for you)
+```
+
+Or run without installing:
+
+```bash
+python -m cp_mcp
+```
+
+## Wire it into a client
+
+The server is launched by your MCP client over stdio. Point the client at either the
+`cp-mcp` console script or `python -m cp_mcp`.
+
+**Claude Desktop** — add to `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "cp-mcp": {
+      "command": "cp-mcp"
+    }
+  }
+}
+```
+
+If `cp-mcp` isn't on the client's PATH, use the interpreter form instead:
+
+```json
+{
+  "mcpServers": {
+    "cp-mcp": {
+      "command": "python",
+      "args": ["-m", "cp_mcp"]
+    }
+  }
+}
+```
+
+**Any other MCP client** (Cursor, Continue, Cline, LM Studio, an open-weight setup, ...):
+register a stdio server with command `cp-mcp` (or `python -m cp_mcp`). No env vars, no keys.
+
+## Example asks
+
+> "What's tourist's current Codeforces rating and their last 5 submissions?"
+> "Give me an unsolved 1600-rated Codeforces DP problem for handle eeshsaxena."
+> "What are today's daily practice problems?"
+> "Show my CodeChef rating history and the next CodeChef contest."
+> "What's today's LeetCode daily challenge?"
+> "Give me all of today's challenges (Codeforces + LeetCode)."
+> "Pull my profile on all three: Codeforces eeshsaxena, CodeChef eeshsaxena, LeetCode eeshsaxena."
+
+## Notes and limits
+
+- **Codeforces** rate-limits the public API to roughly one request every two seconds;
+  a couple of the tools (`cf_solved_stats`, `cf_recommend_problem` with a handle) pull
+  a user's full submission list, so they take a moment for very active accounts.
+- **CodeChef** has no public API, so those tools scrape public HTML. That is inherently
+  fragile: if CodeChef changes its markup or rate-limits the request, fields degrade to
+  `null` or the tool returns an `{"error": ...}` dict rather than crashing.
+- **LeetCode** uses its public GraphQL endpoint (the same one the website uses). It is
+  keyless but undocumented, so a schema change on LeetCode's side could require updates.
+- This project is not affiliated with Codeforces, CodeChef, or LeetCode. Use it within
+  their terms.
+
+## Development
+
+```bash
+pip install -e ".[dev]"
+pytest          # network is fully mocked; tests run offline
+ruff check .
+```
+
+## License
+
+MIT. See [LICENSE](LICENSE).

cp_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,63 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "cp-mcp"
+version = "0.1.0"
+description = "MCP server exposing Codeforces and CodeChef data (ratings, submissions, problems, contests) as tools for any MCP client. No API keys required."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "Eesh Saxena" }]
+keywords = [
+    "mcp",
+    "model-context-protocol",
+    "codeforces",
+    "codechef",
+    "competitive-programming",
+    "llm",
+    "tools",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Topic :: Software Development :: Libraries",
+]
+dependencies = [
+    # mcp 2.x is a breaking rewrite that removed mcp.server.fastmcp (FastMCP -> MCPServer).
+    # This server targets the stable 1.x FastMCP API; the SDK version does not affect
+    # which MCP clients or models can use the server.
+    "mcp>=1.2,<2",
+    "httpx>=0.24",
+]
+
+[project.optional-dependencies]
+dev = ["pytest>=7", "ruff>=0.5"]
+
+[project.urls]
+Homepage = "https://github.com/eeshsaxena/cp-mcp"
+Repository = "https://github.com/eeshsaxena/cp-mcp"
+
+[project.scripts]
+cp-mcp = "cp_mcp.__main__:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/cp_mcp"]
+
+[tool.hatch.build.targets.sdist]
+include = ["src/cp_mcp", "README.md", "LICENSE", "tests"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+
+[tool.ruff.lint]
+select = ["E", "F", "I", "UP", "B"]
+ignore = ["E501"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+pythonpath = ["src"]

cp_mcp-0.1.0/src/cp_mcp/__init__.py

@@ -0,0 +1,4 @@
+"""cp-mcp: MCP server for Codeforces and CodeChef data. No API keys required."""
+
+__version__ = "0.1.0"
+__all__ = ["__version__"]

cp_mcp-0.1.0/src/cp_mcp/__main__.py

@@ -0,0 +1,12 @@
+"""Entry point: run the cp-mcp server over stdio."""
+from __future__ import annotations
+
+from .server import mcp
+
+
+def main() -> None:
+    mcp.run()
+
+
+if __name__ == "__main__":
+    main()

cp_mcp-0.1.0/src/cp_mcp/codechef.py

@@ -0,0 +1,189 @@
+"""CodeChef data via public-page scraping only. No API key, account, or registration.
+
+CodeChef has no usable public API, so this parses the public profile page HTML and
+the site's own no-auth contest-list JSON (the same one the website's own contests
+page calls). Scrapers are inherently fragile: every field degrades to None / an
+error dict rather than crashing if CodeChef changes its markup or blocks the request.
+"""
+from __future__ import annotations
+
+import json
+import re
+from typing import Any
+
+import httpx
+
+BASE = "https://www.codechef.com"
+_UA = (
+    "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 "
+    "(KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36"
+)
+
+_client: httpx.Client | None = None
+
+
+def _get_client() -> httpx.Client:
+    global _client
+    if _client is None:
+        _client = httpx.Client(
+            timeout=25.0,
+            headers={"User-Agent": _UA, "Accept-Language": "en-US,en;q=0.9"},
+            follow_redirects=True,
+        )
+    return _client
+
+
+def _get_text(url: str) -> str:
+    resp = _get_client().get(url)
+    resp.raise_for_status()
+    return resp.text
+
+
+def _get_json(url: str) -> Any:
+    resp = _get_client().get(url, headers={"x-requested-with": "XMLHttpRequest"})
+    resp.raise_for_status()
+    return resp.json()
+
+
+def _stars_for(rating: int | None) -> str | None:
+    if rating is None:
+        return None
+    thresholds = [(1400, 1), (1600, 2), (1800, 3), (2000, 4), (2200, 5), (2500, 6)]
+    n = 7
+    for limit, stars in thresholds:
+        if rating < limit:
+            n = stars
+            break
+    return "★" * n
+
+
+def _search_int(pattern: str, text: str) -> int | None:
+    m = re.search(pattern, text)
+    if not m:
+        return None
+    try:
+        return int(m.group(1).replace(",", ""))
+    except (ValueError, IndexError):
+        return None
+
+
+def _extract_js_array(text: str, var: str) -> list | None:
+    """Return the JSON array literal assigned to `var` in an inline <script>, or None."""
+    i = text.find(var)
+    if i == -1:
+        return None
+    start = text.find("[", i)
+    if start == -1:
+        return None
+    depth = 0
+    for k in range(start, len(text)):
+        c = text[k]
+        if c == "[":
+            depth += 1
+        elif c == "]":
+            depth -= 1
+            if depth == 0:
+                try:
+                    return json.loads(text[start : k + 1])
+                except json.JSONDecodeError:
+                    return None
+    return None
+
+
+def _looks_like_profile(html: str) -> bool:
+    return "rating-number" in html or "rating-ranks" in html
+
+
+def user_info(handle: str) -> dict[str, Any]:
+    html = _get_text(f"{BASE}/users/{handle}")
+    if not _looks_like_profile(html):
+        return {
+            "error": f"Could not read CodeChef profile for '{handle}' "
+            "(user not found, page layout changed, or request blocked)."
+        }
+    rating = _search_int(r'class="rating-number"[^>]*>\s*(\d+)', html)
+    highest = _search_int(r"Highest Rating\s*(\d[\d,]*)", html)
+
+    # rating-ranks block holds global rank then country rank, inside an inline <ul>.
+    # A rank is a number for users active in the latest rated contest, else "Inactive".
+    global_rank = country_rank = None
+    block = re.search(r"rating-ranks(.*?)</ul>", html, re.S)
+    if block:
+        strongs = re.findall(r"<strong>(.*?)</strong>", block.group(1), re.S)
+        vals: list[int | str | None] = []
+        for s in strongs[:2]:
+            s = s.strip()
+            if re.fullmatch(r"[\d,]+", s):
+                vals.append(int(s.replace(",", "")))
+            elif "inactive" in s.lower():
+                vals.append("Inactive")
+            else:
+                vals.append(None)
+        if len(vals) >= 1:
+            global_rank = vals[0]
+        if len(vals) >= 2:
+            country_rank = vals[1]
+
+    country = None
+    m = re.search(r'class="user-country-name"[^>]*>\s*([^<]+?)\s*</', html)
+    if m:
+        country = m.group(1).strip()
+
+    return {
+        "handle": handle,
+        "rating": rating,
+        "stars": _stars_for(rating),
+        "highestRating": highest,
+        "globalRank": global_rank,
+        "countryRank": country_rank,
+        "country": country,
+        "url": f"{BASE}/users/{handle}",
+    }
+
+
+def user_rating(handle: str) -> list[dict[str, Any]]:
+    html = _get_text(f"{BASE}/users/{handle}")
+    raw = _extract_js_array(html, "all_rating")
+    if not raw:
+        if not _looks_like_profile(html):
+            return [{"error": f"Could not read CodeChef profile for '{handle}'."}]
+        return []
+    out = []
+    for e in raw:
+        if not isinstance(e, dict):
+            continue
+        try:
+            rating = int(e["rating"]) if e.get("rating") not in (None, "") else None
+        except (ValueError, TypeError):
+            rating = None
+        try:
+            rank = int(e["rank"]) if e.get("rank") not in (None, "") else None
+        except (ValueError, TypeError):
+            rank = None
+        out.append(
+            {
+                "code": e.get("code"),
+                "name": e.get("name"),
+                "rating": rating,
+                "rank": rank,
+                "endDate": e.get("end_date"),
+            }
+        )
+    return out
+
+
+def upcoming_contests() -> list[dict[str, Any]]:
+    data = _get_json(f"{BASE}/api/list/contests/all")
+    future = data.get("future_contests", []) if isinstance(data, dict) else []
+    out = []
+    for c in future:
+        out.append(
+            {
+                "code": c.get("contest_code"),
+                "name": c.get("contest_name"),
+                "startsUTC": c.get("contest_start_date_iso") or c.get("contest_start_date"),
+                "endsUTC": c.get("contest_end_date_iso") or c.get("contest_end_date"),
+                "url": f"{BASE}/{c.get('contest_code')}" if c.get("contest_code") else None,
+            }
+        )
+    return out