Quickstart Deployment Python MCP Streamable Http Server on AI Agent A2Z¶

Website | GitHub | AI Agent Marketplace | AI Agent A2Z

Introduction¶

This server implement one tool greeting and one resource index (html in assets folder) in a mcp.streamable_http_app() at “/mcp” endpoint

Locally¶

pnpm install
pnpm build
pnpm start

Test Local MCP Connection¶

http://127.0.0.1:8000/mcp

Test Static Resource Serving¶

http://127.0.0.1:8000/assets/index.html

Rendered content: Typescript MCP Example And you can see the static file in on /assets/* folder and served

Deployment¶

Create AI Service at AI Service Project
Go to A2Z Deployment Panel Choose Github Method Public URL: https://github.com/aiagenta2z/agent-mcp-deployment-templates/tree/main/quickstart/mcp_typescript Entry Point Starting Script:

pnpm --prefix ./quickstart/mcp_typescript install
pnpm --prefix ./quickstart/mcp_typescript build
pnpm --prefix ./quickstart/mcp_typescript start

Note the command should be run from the root folder of the git project with prefix ./quickstart/mcp_typescript

Deploy

Everything will be done in a few minutes and Note that the server starting script should start from the github root folder as module

Result

Test Local MCP Connection¶

https://quickstart.aiagenta2z.com/mcp_typescript/mcp

Cursor: Add/Greet User

{
    "mcpServers": {
        "quickstart-mcp-node": {
          "url": "https://quickstart.aiagenta2z.com/mcp_typescript/mcp"
        }    
    }
}

assets https://quickstart.aiagenta2z.com/mcp_typescript/assets/index.html

If you can see the content:

Result¶

Successful Logs

2026-02-22 12:31:39.694 [info] listResources: Found 0 resources
2026-02-22 12:31:39.694 [info] Found 1 tools, 1 prompts, and 0 resources
2026-02-22 12:31:39.715 [info] Handling GetInstructions action