initial commit

Author: eleanorjboyd

.gitignore

@@ -0,0 +1,3 @@
+.venv
+.DS_Store
+**.egg-info**

.vscode/mcp.json

@@ -0,0 +1,7 @@
+{
+    "servers": {
+        "pipy-info": {
+            "url": "http://0.0.0.0:8000/sse"
+        }
+    }
+}

README.md

@@ -0,0 +1,37 @@
+# PyPI Info Demo
+
+This project is a simple Model Context Protocol (MCP) server that provides information about Python packages on PyPI. It exposes a tool to fetch package maintainers, version, changelog, summary, and full project description using the PyPI JSON API.
+
+## Features
+- Query PyPI for package metadata
+- Returns maintainers, version, changelog URL, summary, and full project description
+- Attempts to find changelog links from project homepages if not directly available
+
+## Usage
+
+1. **Install dependencies:**
+using the python environments extension run the command "create environment"
+or install via `pip install -e .`
+
+2. **Run the server:**
+   ```sh
+   python server.py
+   ```
+
+3. **Call the tool:**
+   You can call the `get_pypi_package_info` tool via the MCP protocol, or directly in Python:
+   ```python
+   from server import get_pypi_package_info
+   print(get_pypi_package_info("requests"))
+   ```
+
+## File Overview
+- `server.py`: Main MCP server and PyPI info tool implementation
+- `pyproject.toml`: Project metadata and dependencies
+
+## Requirements
+- Python 3.7+
+- `mcp`, `requests`, `beautifulsoup4`
+
+## License
+MIT

pyproject.toml

@@ -0,0 +1,17 @@
+[project]
+name = "mcp-demo-pypi"
+version = "0.1.0"
+description = "A MCP server to get info from pypi."
+requires-python = ">=3.10"
+license = "MIT"
+readme = "README.md"
+dependencies = [
+    "mcp[cli]>=1.6",
+    "fastapi>=0.115",
+    "requests>=2.32",
+    "beautifulsoup4>=4.13"
+]
+
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"

server.py

@@ -0,0 +1,71 @@
+from mcp.server.fastmcp import FastMCP
+import requests
+from bs4 import BeautifulSoup
+
+
+# Create an MCP server
+mcp = FastMCP("PyPI Info Demo")
+
+
+# MCP tool for PyPI package info
+@mcp.tool()
+def get_pypi_package_info(package_name: str) -> dict:
+    """
+    Fetches package info from PyPI for the given package name.
+    Returns a dictionary with maintainers, version, changelog, and description.
+    """
+    url = f"https://pypi.org/pypi/{package_name}/json"
+    resp = requests.get(url)
+    if resp.status_code != 200:
+        raise ValueError(f"Package '{package_name}' not found on PyPI.")
+    data = resp.json()
+    info = data.get("info", {})
+    # Maintainers: PyPI does not always provide maintainers, fallback to author/maintainer fields
+    maintainers = info.get("maintainer")
+    if not maintainers:
+        maintainers = info.get("author")
+    version = info.get("version")
+    description = info.get("summary") or info.get("description")
+    project_description = info.get("description")
+    # Try to get changelog from project_urls or homepage
+    changelog = None
+    project_urls = info.get("project_urls", {})
+    for key in project_urls:
+        if "changelog" in key.lower() or "changes" in key.lower():
+            changelog = project_urls[key]
+            break
+    if not changelog:
+        # Try to find a changelog in the homepage or repository
+        for key in project_urls:
+            if "home" in key.lower() or "repo" in key.lower():
+                homepage_url = project_urls[key]
+                try:
+                    page = requests.get(homepage_url, timeout=5)
+                    if page.ok:
+                        soup = BeautifulSoup(page.text, "html.parser")
+                        for a in soup.find_all("a", href=True):
+                            if (
+                                "changelog" in a.text.lower()
+                                or "changes" in a.text.lower()
+                            ):
+                                changelog = a["href"]
+                                break
+                        if changelog:
+                            break
+                except Exception:
+                    pass
+    return {
+        "maintainers": maintainers,
+        "version": version,
+        "changelog": changelog,
+        "description": description,
+        "project_description": project_description,
+    }
+
+
+if __name__ == "__main__":
+    # Start the MCP server
+    mcp.run(transport="sse")
+
+    # Example usage to call the function directly
+    print(get_pypi_package_info("requests"))