devnet: MCP tool map over the same backend

src/devnet/mcp_server.py

@@ -0,0 +1,41 @@
+"""MCP surface - a thin map over the same backend the REST API uses."""
+from __future__ import annotations
+
+from mcp.server.fastmcp import FastMCP
+
+from .sources import github, hackernews, pypi, rss
+
+mcp = FastMCP("devnet", instructions="Read-only access to the developer internet.")
+
+
+@mcp.tool()
+def pypi_package(name: str) -> dict:
+    """Current version, dependencies, yanked status and release history for a PyPI project."""
+    return pypi.package(name)
+
+
+@mcp.tool()
+def github_repository(owner: str, name: str) -> dict:
+    """Metadata, stars, language, license and topics for a public GitHub repository."""
+    return github.repository(owner, name)
+
+
+@mcp.tool()
+def github_issues(owner: str, name: str, state: str = "open", limit: int = 20) -> dict:
+    """Issues for a public GitHub repository. Pull requests are filtered out."""
+    return github.issues(owner, name, state, limit)
+
+
+@mcp.tool()
+def hackernews_search(query: str, limit: int = 20, kind: str = "all") -> dict:
+    """Search Hacker News. kind: all, story, comment, show_hn, ask_hn."""
+    return hackernews.search(query, limit, kind)
+
+
+@mcp.tool()
+def rss_read(url: str, limit: int = 20) -> dict:
+    """Read any public RSS or Atom feed as normalized entries."""
+    return rss.read(url, limit)
+
+
+mcp_app = mcp.streamable_http_app()