meddata-mcp 0.1.0__tar.gz

meddata_mcp-0.1.0/.gitignore

@@ -0,0 +1,41 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+*.egg-info/
+*.egg
+dist/
+build/
+eggs/
+*.whl
+
+# Virtual environments
+.venv/
+venv/
+env/
+ENV/
+
+# Environment variables
+.env
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Testing
+.pytest_cache/
+.coverage
+htmlcov/
+.mypy_cache/
+
+# Distribution
+*.tar.gz
+*.zip

meddata_mcp-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Anthesia
+
+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.

meddata_mcp-0.1.0/PKG-INFO

@@ -0,0 +1,123 @@
+Metadata-Version: 2.4
+Name: meddata-mcp
+Version: 0.1.0
+Summary: MCP server for the MedData API: drug and supplement lookup and interaction checks from free U.S. government health databases.
+Project-URL: Homepage, https://meddata.anthesia.io
+Project-URL: Documentation, https://meddata.anthesia.io/docs
+Project-URL: Repository, https://github.com/anthesiallc/meddata-api
+Author-email: Anthesia <support@anthesia.io>
+License: MIT
+License-File: LICENSE
+Keywords: drug,fda,healthcare,interactions,mcp,model-context-protocol,openfda,pharmacy,rxnorm,supplement
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: Medical Science Apps.
+Requires-Python: >=3.10
+Requires-Dist: httpx>=0.27.0
+Requires-Dist: mcp>=1.2.0
+Description-Content-Type: text/markdown
+
+# MedData MCP Server
+
+mcp-name: io.github.anthesiallc/meddata
+
+A [Model Context Protocol](https://modelcontextprotocol.io) server that exposes the
+[MedData API](https://meddata.anthesia.io) as tools, so any MCP client (Claude
+Desktop, Cursor, ChatGPT connectors, or an agent framework) can look up drug and
+supplement data and check interactions conversationally.
+
+It's a thin wrapper: each tool maps to one MedData REST endpoint. All the data
+work happens in the API.
+
+## Tools
+
+| Tool | What it does |
+|------|--------------|
+| `search_drugs` | Search drugs by brand or generic name; returns RxCUI + details |
+| `get_drug` | Full drug profile by RxCUI |
+| `get_drug_by_ndc` | Drug profile by NDC package code |
+| `search_supplements` | Search supplements by name; returns supplement IDs |
+| `get_supplement` | Full supplement fact sheet by ID |
+| `check_interactions` | Interactions across a mixed list of 2-10 drugs/supplements |
+| `get_usage` | Current billing period usage and plan limit |
+
+## Get an API key
+
+Free tier is 250 calls/month, no credit card:
+
+```bash
+curl -X POST https://meddata.anthesia.io/api/v1/signup \
+  -H 'Content-Type: application/json' \
+  -d '{"email":"you@example.com"}'
+```
+
+The key comes back in the `api_key` field of the response.
+
+## Install and run
+
+The easiest way is with [uv](https://docs.astral.sh/uv/) (no manual venv needed):
+
+```bash
+# stdio transport (default — for Claude Desktop, Cursor, most local clients)
+MEDDATA_API_KEY=md_your_key uvx meddata-mcp
+
+# streamable-HTTP transport (for remote / web clients)
+MEDDATA_API_KEY=md_your_key uvx meddata-mcp --http
+```
+
+Or install with pip into its own environment:
+
+```bash
+pip install meddata-mcp
+MEDDATA_API_KEY=md_your_key meddata-mcp
+```
+
+> Note: install into a dedicated environment. The `mcp` SDK requires a newer
+> `starlette` than the MedData API app pins, so the two will conflict if installed
+> together.
+
+Environment variables:
+
+- `MEDDATA_API_KEY` (required) — your MedData API key.
+- `MEDDATA_BASE_URL` (optional) — defaults to `https://meddata.anthesia.io`.
+- `MEDDATA_TIMEOUT` (optional) — request timeout in seconds, default `30`.
+
+## Client configuration
+
+### Claude Desktop
+
+Add to `claude_desktop_config.json` (Settings → Developer → Edit Config):
+
+```json
+{
+  "mcpServers": {
+    "meddata": {
+      "command": "uvx",
+      "args": ["meddata-mcp"],
+      "env": { "MEDDATA_API_KEY": "md_your_key" }
+    }
+  }
+}
+```
+
+### Cursor
+
+Add the same block to `~/.cursor/mcp.json` (or the project `.cursor/mcp.json`).
+
+## Develop from source
+
+```bash
+cd mcp_server
+python -m venv .venv
+.venv/Scripts/python -m pip install -e .   # Windows
+# .venv/bin/pip install -e .                # macOS/Linux
+MEDDATA_API_KEY=md_your_key .venv/Scripts/python -m meddata_mcp.server
+```
+
+## Notes
+
+- Data is for informational purposes only and is not medical advice.
+- Interaction data comes from established medical databases; an empty result
+  means none were found in those sources, not that a combination is proven safe.

meddata_mcp-0.1.0/README.md

@@ -0,0 +1,102 @@
+# MedData MCP Server
+
+mcp-name: io.github.anthesiallc/meddata
+
+A [Model Context Protocol](https://modelcontextprotocol.io) server that exposes the
+[MedData API](https://meddata.anthesia.io) as tools, so any MCP client (Claude
+Desktop, Cursor, ChatGPT connectors, or an agent framework) can look up drug and
+supplement data and check interactions conversationally.
+
+It's a thin wrapper: each tool maps to one MedData REST endpoint. All the data
+work happens in the API.
+
+## Tools
+
+| Tool | What it does |
+|------|--------------|
+| `search_drugs` | Search drugs by brand or generic name; returns RxCUI + details |
+| `get_drug` | Full drug profile by RxCUI |
+| `get_drug_by_ndc` | Drug profile by NDC package code |
+| `search_supplements` | Search supplements by name; returns supplement IDs |
+| `get_supplement` | Full supplement fact sheet by ID |
+| `check_interactions` | Interactions across a mixed list of 2-10 drugs/supplements |
+| `get_usage` | Current billing period usage and plan limit |
+
+## Get an API key
+
+Free tier is 250 calls/month, no credit card:
+
+```bash
+curl -X POST https://meddata.anthesia.io/api/v1/signup \
+  -H 'Content-Type: application/json' \
+  -d '{"email":"you@example.com"}'
+```
+
+The key comes back in the `api_key` field of the response.
+
+## Install and run
+
+The easiest way is with [uv](https://docs.astral.sh/uv/) (no manual venv needed):
+
+```bash
+# stdio transport (default — for Claude Desktop, Cursor, most local clients)
+MEDDATA_API_KEY=md_your_key uvx meddata-mcp
+
+# streamable-HTTP transport (for remote / web clients)
+MEDDATA_API_KEY=md_your_key uvx meddata-mcp --http
+```
+
+Or install with pip into its own environment:
+
+```bash
+pip install meddata-mcp
+MEDDATA_API_KEY=md_your_key meddata-mcp
+```
+
+> Note: install into a dedicated environment. The `mcp` SDK requires a newer
+> `starlette` than the MedData API app pins, so the two will conflict if installed
+> together.
+
+Environment variables:
+
+- `MEDDATA_API_KEY` (required) — your MedData API key.
+- `MEDDATA_BASE_URL` (optional) — defaults to `https://meddata.anthesia.io`.
+- `MEDDATA_TIMEOUT` (optional) — request timeout in seconds, default `30`.
+
+## Client configuration
+
+### Claude Desktop
+
+Add to `claude_desktop_config.json` (Settings → Developer → Edit Config):
+
+```json
+{
+  "mcpServers": {
+    "meddata": {
+      "command": "uvx",
+      "args": ["meddata-mcp"],
+      "env": { "MEDDATA_API_KEY": "md_your_key" }
+    }
+  }
+}
+```
+
+### Cursor
+
+Add the same block to `~/.cursor/mcp.json` (or the project `.cursor/mcp.json`).
+
+## Develop from source
+
+```bash
+cd mcp_server
+python -m venv .venv
+.venv/Scripts/python -m pip install -e .   # Windows
+# .venv/bin/pip install -e .                # macOS/Linux
+MEDDATA_API_KEY=md_your_key .venv/Scripts/python -m meddata_mcp.server
+```
+
+## Notes
+
+- Data is for informational purposes only and is not medical advice.
+- Interaction data comes from established medical databases; an empty result
+  means none were found in those sources, not that a combination is proven safe.

meddata_mcp-0.1.0/meddata_mcp/__init__.py

@@ -0,0 +1,3 @@
+"""MedData MCP server package."""
+
+__version__ = "0.1.0"

meddata_mcp-0.1.0/meddata_mcp/server.py

@@ -0,0 +1,187 @@
+"""MedData MCP server.
+
+Exposes the MedData REST API (https://meddata.anthesia.io) as Model Context
+Protocol tools so that agents and MCP-capable clients (Claude Desktop, Cursor,
+ChatGPT connectors, agent frameworks) can look up drug and supplement data and
+check interactions conversationally.
+
+This is a thin wrapper: every tool maps to one REST endpoint. The API key is
+read from the MEDDATA_API_KEY environment variable. Get a free key (250
+calls/month, no card) from https://meddata.anthesia.io or by POSTing your email
+to /api/v1/signup -- the key comes back in the response.
+
+Run it:
+    MEDDATA_API_KEY=md_... meddata-mcp                 # stdio (default)
+    MEDDATA_API_KEY=md_... meddata-mcp --http          # streamable-http
+    MEDDATA_API_KEY=md_... python -m meddata_mcp.server # equivalent
+
+Drug and supplement data is for informational purposes only and is not medical
+advice. Interaction data comes from established medical databases; it is never
+generated or inferred.
+"""
+
+import os
+import sys
+from typing import Any
+
+import httpx
+from mcp.server.fastmcp import FastMCP
+
+BASE_URL = os.environ.get("MEDDATA_BASE_URL", "https://meddata.anthesia.io").rstrip("/")
+API_KEY = os.environ.get("MEDDATA_API_KEY", "")
+TIMEOUT = float(os.environ.get("MEDDATA_TIMEOUT", "30"))
+
+mcp = FastMCP(
+    "meddata",
+    instructions=(
+        "Tools for looking up drug and supplement information and checking "
+        "interactions, backed by free U.S. government health databases (openFDA, "
+        "RxNorm, DailyMed, FDA Orange Book, NADAC, NIH ODS). Use search_drugs / "
+        "search_supplements to find an item, then get_drug / get_supplement for "
+        "the full profile, and check_interactions to screen a list of drugs and "
+        "supplements together. Results are informational only, not medical advice."
+    ),
+)
+
+
+async def _get(path: str, params: dict[str, Any] | None = None) -> dict[str, Any]:
+    """Call a MedData GET endpoint and return parsed JSON (or an error dict)."""
+    if not API_KEY:
+        return {
+            "error": "missing_api_key",
+            "detail": (
+                "Set the MEDDATA_API_KEY environment variable. Get a free key at "
+                "https://meddata.anthesia.io (no credit card)."
+            ),
+        }
+    headers = {"X-API-Key": API_KEY, "Accept": "application/json"}
+    try:
+        async with httpx.AsyncClient(timeout=TIMEOUT) as client:
+            resp = await client.get(f"{BASE_URL}{path}", params=params, headers=headers)
+    except httpx.RequestError as exc:
+        return {"error": "network_error", "detail": str(exc)}
+
+    if resp.status_code >= 400:
+        # The API returns a structured ErrorResponse; pass its detail through.
+        try:
+            body = resp.json()
+        except ValueError:
+            body = {"detail": resp.text[:500]}
+        return {
+            "error": f"http_{resp.status_code}",
+            "detail": body.get("detail") or body.get("error") or "Request failed.",
+            "status_code": resp.status_code,
+        }
+    try:
+        return resp.json()
+    except ValueError:
+        return {"error": "bad_response", "detail": "API returned non-JSON content."}
+
+
+def _join(items: list[str]) -> str:
+    """Join a list of names into the comma-separated form the API expects."""
+    return ",".join(i.strip() for i in items if i and i.strip())
+
+
+@mcp.tool()
+async def search_drugs(name: str, limit: int = 10) -> dict[str, Any]:
+    """Search for drugs by brand or generic name.
+
+    Returns matching drugs with their RxCUI (the identifier you pass to
+    get_drug), generic and brand names, and dosage form/strength when known.
+    Use this first when you have a drug name but need its details or RxCUI.
+
+    Args:
+        name: Brand or generic drug name, e.g. "aspirin" or "Lipitor".
+        limit: Max results to return (1-50).
+    """
+    return await _get("/api/v1/drugs/search", {"name": name, "limit": limit})
+
+
+@mcp.tool()
+async def get_drug(rxcui: str) -> dict[str, Any]:
+    """Get the full profile for a drug by its RxCUI.
+
+    Returns names, dosage forms, NDC codes, label sections, and related data.
+    Get the RxCUI from search_drugs first if you only have a name.
+
+    Args:
+        rxcui: RxNorm Concept Unique Identifier, e.g. "1191" for aspirin.
+    """
+    return await _get(f"/api/v1/drugs/{rxcui}")
+
+
+@mcp.tool()
+async def get_drug_by_ndc(ndc_code: str) -> dict[str, Any]:
+    """Get a drug profile by its NDC (National Drug Code) package code.
+
+    Use when you have an NDC from a label or packaging rather than a name.
+
+    Args:
+        ndc_code: NDC code, e.g. "0363-0160".
+    """
+    return await _get(f"/api/v1/drugs/ndc/{ndc_code}")
+
+
+@mcp.tool()
+async def search_supplements(name: str, limit: int = 10) -> dict[str, Any]:
+    """Search for dietary supplements by name.
+
+    Returns matching supplements with their IDs (pass to get_supplement) and
+    summary info. Use first when you have a supplement name like "Vitamin D"
+    or "Fish Oil".
+
+    Args:
+        name: Supplement name, e.g. "Vitamin D" or "magnesium".
+        limit: Max results to return (1-50).
+    """
+    return await _get("/api/v1/supplements/search", {"name": name, "limit": limit})
+
+
+@mcp.tool()
+async def get_supplement(supplement_id: int) -> dict[str, Any]:
+    """Get the full fact sheet for a supplement by its ID.
+
+    Returns ingredients, recommended intake, and NIH reference data. Get the ID
+    from search_supplements first.
+
+    Args:
+        supplement_id: Numeric supplement ID from search_supplements.
+    """
+    return await _get(f"/api/v1/supplements/{supplement_id}")
+
+
+@mcp.tool()
+async def check_interactions(items: list[str]) -> dict[str, Any]:
+    """Check interactions across a mixed list of drugs and supplements.
+
+    Accepts 2-10 items (drug names, supplement names, or both) and returns known
+    interactions among them. Interaction data comes from established medical
+    databases; it is never generated or inferred, so an empty result means none
+    were found in those sources, not that the combination is proven safe.
+
+    Args:
+        items: 2-10 drug and/or supplement names,
+            e.g. ["warfarin", "aspirin", "Fish Oil"].
+    """
+    if len(items) < 2:
+        return {"error": "too_few_items", "detail": "Provide at least 2 items to compare."}
+    if len(items) > 10:
+        return {"error": "too_many_items", "detail": "Provide at most 10 items."}
+    return await _get("/api/v1/interactions/check", {"items": _join(items)})
+
+
+@mcp.tool()
+async def get_usage() -> dict[str, Any]:
+    """Show this API key's current billing period usage and plan limits."""
+    return await _get("/api/v1/billing/usage")
+
+
+def main() -> None:
+    """Run the MCP server. Use --http for streamable-HTTP, otherwise stdio."""
+    transport = "streamable-http" if "--http" in sys.argv else "stdio"
+    mcp.run(transport=transport)
+
+
+if __name__ == "__main__":
+    main()

meddata_mcp-0.1.0/pyproject.toml

@@ -0,0 +1,46 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "meddata-mcp"
+version = "0.1.0"
+description = "MCP server for the MedData API: drug and supplement lookup and interaction checks from free U.S. government health databases."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "Anthesia", email = "support@anthesia.io" }]
+keywords = [
+    "mcp",
+    "model-context-protocol",
+    "drug",
+    "supplement",
+    "interactions",
+    "fda",
+    "openfda",
+    "rxnorm",
+    "healthcare",
+    "pharmacy",
+]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Intended Audience :: Developers",
+    "Topic :: Scientific/Engineering :: Medical Science Apps.",
+]
+dependencies = [
+    "mcp>=1.2.0",
+    "httpx>=0.27.0",
+]
+
+[project.urls]
+Homepage = "https://meddata.anthesia.io"
+Documentation = "https://meddata.anthesia.io/docs"
+Repository = "https://github.com/anthesiallc/meddata-api"
+
+[project.scripts]
+meddata-mcp = "meddata_mcp.server:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["meddata_mcp"]

meddata_mcp-0.1.0/server.json

@@ -0,0 +1,29 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-07-09/server.json",
+  "name": "io.github.anthesiallc/meddata",
+  "description": "Look up U.S. drug and supplement data and check interactions, from free government health databases (openFDA, RxNorm, NIH ODS).",
+  "status": "active",
+  "version": "0.1.0",
+  "repository": {
+    "url": "https://github.com/anthesiallc/meddata-api",
+    "source": "github"
+  },
+  "packages": [
+    {
+      "registryType": "pypi",
+      "identifier": "meddata-mcp",
+      "version": "0.1.0",
+      "transport": {
+        "type": "stdio"
+      },
+      "environmentVariables": [
+        {
+          "name": "MEDDATA_API_KEY",
+          "description": "MedData API key. Get a free one (250 calls/month, no card) at https://meddata.anthesia.io",
+          "isRequired": true,
+          "isSecret": true
+        }
+      ]
+    }
+  ]
+}