Marcelo Trylesinski
85 lines
2.8 KiB
Python
85 lines
2.8 KiB
Python
"""Simple task server demonstrating MCP tasks over streamable HTTP."""
|
|
|
|
from collections.abc import AsyncIterator
|
|
from contextlib import asynccontextmanager
|
|
from typing import Any
|
|
|
|
import anyio
|
|
import click
|
|
import mcp.types as types
|
|
import uvicorn
|
|
from mcp.server.experimental.task_context import ServerTaskContext
|
|
from mcp.server.lowlevel import Server
|
|
from mcp.server.streamable_http_manager import StreamableHTTPSessionManager
|
|
from starlette.applications import Starlette
|
|
from starlette.routing import Mount
|
|
|
|
server = Server("simple-task-server")
|
|
|
|
# One-line setup: auto-registers get_task, get_task_result, list_tasks, cancel_task
|
|
server.experimental.enable_tasks()
|
|
|
|
|
|
@server.list_tools()
|
|
async def list_tools() -> list[types.Tool]:
|
|
return [
|
|
types.Tool(
|
|
name="long_running_task",
|
|
description="A task that takes a few seconds to complete with status updates",
|
|
input_schema={"type": "object", "properties": {}},
|
|
execution=types.ToolExecution(task_support=types.TASK_REQUIRED),
|
|
)
|
|
]
|
|
|
|
|
|
async def handle_long_running_task(arguments: dict[str, Any]) -> types.CreateTaskResult:
|
|
"""Handle the long_running_task tool - demonstrates status updates."""
|
|
ctx = server.request_context
|
|
ctx.experimental.validate_task_mode(types.TASK_REQUIRED)
|
|
|
|
async def work(task: ServerTaskContext) -> types.CallToolResult:
|
|
await task.update_status("Starting work...")
|
|
await anyio.sleep(1)
|
|
|
|
await task.update_status("Processing step 1...")
|
|
await anyio.sleep(1)
|
|
|
|
await task.update_status("Processing step 2...")
|
|
await anyio.sleep(1)
|
|
|
|
return types.CallToolResult(content=[types.TextContent(type="text", text="Task completed!")])
|
|
|
|
return await ctx.experimental.run_task(work)
|
|
|
|
|
|
@server.call_tool()
|
|
async def handle_call_tool(name: str, arguments: dict[str, Any]) -> types.CallToolResult | types.CreateTaskResult:
|
|
"""Dispatch tool calls to their handlers."""
|
|
if name == "long_running_task":
|
|
return await handle_long_running_task(arguments)
|
|
else:
|
|
return types.CallToolResult(
|
|
content=[types.TextContent(type="text", text=f"Unknown tool: {name}")],
|
|
is_error=True,
|
|
)
|
|
|
|
|
|
@click.command()
|
|
@click.option("--port", default=8000, help="Port to listen on")
|
|
def main(port: int) -> int:
|
|
session_manager = StreamableHTTPSessionManager(app=server)
|
|
|
|
@asynccontextmanager
|
|
async def app_lifespan(app: Starlette) -> AsyncIterator[None]:
|
|
async with session_manager.run():
|
|
yield
|
|
|
|
starlette_app = Starlette(
|
|
routes=[Mount("/mcp", app=session_manager.handle_request)],
|
|
lifespan=app_lifespan,
|
|
)
|
|
|
|
print(f"Starting server on http://localhost:{port}/mcp")
|
|
uvicorn.run(starlette_app, host="127.0.0.1", port=port)
|
|
return 0
|