nanohub-mcp

A zero-dependency Python library for creating Model Context Protocol (MCP) servers that integrate with nanoHUB/HubZero tools infrastructure.

Features:

• Zero external dependencies (stdlib only)

• Python 3.7+ compatible

• SSE and Streamable HTTP transports

• OpenAPI schema auto-generation

• Direct REST-style tool calls

• nanoHUB proxy integration out of the box

• Context injection for logging, progress reporting, and elicitation

• Async tools for long-running jobs (no proxy timeout)

Installation

pip install nanohub-mcp

Contents

• Quick Start
• Examples
  • Long-Running Async Tool
  • Elicitation
  • Simple Calculator
  • Data Analysis
  • Physics Simulator
• Connecting MCP Clients
  • VS Code (GitHub Copilot)
  • Antigravity
  • OpenAI Codex
  • Claude Desktop
  • Multiple Tools
  • Local Development
• API Reference
  • MCPServer
  • @server.tool()
  • @server.async_tool()
  • @server.resource()
  • @server.prompt()
  • Context
  • Return Types
• Testing Your Server
  • Using curl
  • Python Test Client
  • Running the Test Suite
• Server Endpoints
  • SSE Transport (/sse)
  • Streamable HTTP Transport (/mcp)
  • JSON-RPC Methods
  • Direct Tool Calls (/tools/<name>)
  • OpenAPI Schema (/openapi.json)
  • MCP Discovery (/.well-known/mcp.json)
  • Error Handling
• Running on nanoHUB
  • CLI Usage
  • How It Works
  • Proxy URL Format
  • Testing Through the Proxy
  • Using the nanoHUB API
  • Local Development