pywss

Overview

Pywss is a Python web framework designed with a focus on simplicity and performance, providing an easy way to build MCP servers. The framework integrates MCP protocols directly into its architecture, allowing developers to create MCP tools using a clean, Gin/Iris-like syntax. It features automatic OpenAPI documentation generation, WebSocket support, and built-in API testing capabilities. The framework uses a thread pool mechanism for better concurrency handling and provides standardized error handling responses for MCP services.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• tool_get_domaintool_get_domain(domain: str)

  获取单个域名服务

  Try:获取域名的服务信息Try:查询 domain.com 的服务状态Try:获取指定域名的详细配置
• tool_get_trace_logtool_get_trace_log(traceId: str)

  获取单个trace日志

  Try:获取trace ID为123的日志Try:查询特定跟踪的日志信息Try:获取跟踪ID abc123 的详细日志

Comparable tools

Installation

pip install pywss

from pywss import App
from pywss.mcp import MCPServer
from pydantic import BaseModel

class MyRequest(BaseModel):
    param: str

class MyMCPServer(MCPServer):
    @pywss.openapi.docs(description="My tool", request=MyRequest)
    def tool_my_tool(self, ctx):
        req = ctx.data.req
        self.handle_success(ctx, {"result": req.param})

app = App()
server = MyMCPServer()
server.mount(app.group("/mcp"))
app.run()

FAQ

What MCP protocols does Pywss support?

Pywss supports three MCP protocols: SSE (Server-Sent Events), StreamHTTP, and MCPO (Model Context Protocol Object).

How do I define MCP tools in Pywss?

Define methods with the 'tool_' prefix, use @pywss.openapi.docs decorator to specify parameters, and handle responses with handle_success() or handle_error().

Compare pywss with