Skip to content

fenic.api.mcp.server

Create MCP servers using Fenic DataFrames.

This module exposes helpers to: - Build a Fenic-backed MCP server from datasets and tools - Run the server synchronously or asynchronously

Functions:

create_mcp_server 

create_mcp_server(session: Session, server_name: str, *, tools: Optional[List[ParameterizedToolDefinition]] = None, concurrency_limit: int = 8) -> FenicMCPServer

Create an MCP server from datasets and tools.

Parameters:

  • session (Session) –

    Fenic session used to execute tools.

  • server_name (str) –

    Name of the MCP server.

  • tools (Optional[List[ParameterizedToolDefinition]], default: None ) –

    Tools to register (optional).

  • concurrency_limit (int, default: 8 ) –

    Maximum number of concurrent tool executions.

Source code in src/fenic/api/mcp/server.py 
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
def create_mcp_server(
    session: Session,
    server_name: str,
    *,
    tools: Optional[List[ParameterizedToolDefinition]] = None,
    concurrency_limit: int = 8,
) -> FenicMCPServer:
    """Create an MCP server from datasets and tools.

    Args:
        session: Fenic session used to execute tools.
        server_name: Name of the MCP server.
        tools: Tools to register (optional).
        concurrency_limit: Maximum number of concurrent tool executions.
    """
    if tools is None:
        tools = []
    if not tools:
        raise ConfigurationError("No tools provided. Either provide tools or register them to catalog.")
    return FenicMCPServer(session._session_state, tools, server_name, concurrency_limit)

run_mcp_server_asgi 

run_mcp_server_asgi(server: FenicMCPServer, *, stateless_http: bool = True, port: Optional[int] = None, host: Optional[str] = None, path: Optional[str] = '/mcp', **kwargs)

Run an MCP server as a Starlette ASGI app.

Returns a Starlette ASGI app that can be integrated into any ASGI server. This is useful for running the MCP server in a production environment, or running the MCP server as part of a larger application.

Parameters:

  • server (FenicMCPServer) –

    MCP server to run.

  • stateless_http (bool, default: True ) –

    If True, use stateless HTTP.

  • port (Optional[int], default: None ) –

    Port to listen on.

  • host (Optional[str], default: None ) –

    Host to listen on.

  • path (Optional[str], default: '/mcp' ) –

    Path to listen on.

  • kwargs –

    Additional transport-specific arguments to pass to FastMCP.

Notes

Some additional possible keyword arguments: - middleware: A list of Starlette ASGIMiddleware middleware to apply to the app.

Source code in src/fenic/api/mcp/server.py 
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
def run_mcp_server_asgi(
    server: FenicMCPServer,
    *,
    stateless_http: bool = True,
    port: Optional[int] = None,
    host: Optional[str] = None,
    path: Optional[str] = "/mcp",
    **kwargs,
):
    """Run an MCP server as a Starlette ASGI app.

    Returns a Starlette ASGI app that can be integrated into any ASGI server.
    This is useful for running the MCP server in a production environment, or running the MCP server as part of a larger application.

    Args:
        server: MCP server to run.
        stateless_http: If True, use stateless HTTP.
        port: Port to listen on.
        host: Host to listen on.
        path: Path to listen on.
        kwargs: Additional transport-specific arguments to pass to FastMCP.

    Notes:
        Some additional possible keyword arguments:
        - `middleware`: A list of Starlette `ASGIMiddleware` middleware to apply to the app.
    """
    return server.http_app(stateless_http=stateless_http, port=port, host=host, path=path, **kwargs)

run_mcp_server_async async 

run_mcp_server_async(server: FenicMCPServer, *, transport: MCPTransport = 'http', stateless_http: bool = True, port: Optional[int] = None, host: Optional[str] = None, path: Optional[str] = '/mcp', **kwargs)

Run an MCP server asynchronously.

Use this when calling from asynchronous code. This does not create a new event loop.

Parameters:

  • server (FenicMCPServer) –

    MCP server to run.

  • transport (MCPTransport, default: 'http' ) –

    Transport protocol (http, stdio).

  • stateless_http (bool, default: True ) –

    If True, use stateless HTTP.

  • port (Optional[int], default: None ) –

    Port to listen on.

  • host (Optional[str], default: None ) –

    Host to listen on.

  • path (Optional[str], default: '/mcp' ) –

    Path to listen on.

  • kwargs –

    Additional transport-specific arguments to pass to FastMCP.

Source code in src/fenic/api/mcp/server.py 
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
async def run_mcp_server_async(
    server: FenicMCPServer,
    *,
    transport: MCPTransport = "http",
    stateless_http: bool = True,
    port: Optional[int] = None,
    host: Optional[str] = None,
    path: Optional[str] = "/mcp",
    **kwargs,
):
    """Run an MCP server asynchronously.

    Use this when calling from asynchronous code. This does not create a new event loop.

    Args:
        server: MCP server to run.
        transport: Transport protocol (http, stdio).
        stateless_http: If True, use stateless HTTP.
        port: Port to listen on.
        host: Host to listen on.
        path: Path to listen on.
        kwargs: Additional transport-specific arguments to pass to FastMCP.
    """
    await server.run_async(transport=transport, stateless_http=stateless_http, port=port, host=host, path=path, **kwargs)

run_mcp_server_sync 

run_mcp_server_sync(server: FenicMCPServer, *, transport: MCPTransport = 'http', stateless_http: bool = True, port: Optional[int] = None, host: Optional[str] = None, path: Optional[str] = '/mcp', **kwargs)

Run an MCP server synchronously.

Use this when calling from synchronous code. This creates a new event loop and runs the server in it.

Parameters:

  • server (FenicMCPServer) –

    MCP server to run.

  • transport (MCPTransport, default: 'http' ) –

    Transport protocol (http, stdio).

  • stateless_http (bool, default: True ) –

    If True, use stateless HTTP.

  • port (Optional[int], default: None ) –

    Port to listen on.

  • host (Optional[str], default: None ) –

    Host to listen on.

  • path (Optional[str], default: '/mcp' ) –

    Path to listen on.

  • kwargs –

    Additional transport-specific arguments to pass to FastMCP.

Source code in src/fenic/api/mcp/server.py 
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
def run_mcp_server_sync(
    server: FenicMCPServer,
    *,
    transport: MCPTransport = "http",
    stateless_http: bool = True,
    port: Optional[int] = None,
    host: Optional[str] = None,
    path: Optional[str] = "/mcp",
    **kwargs,
):
    """Run an MCP server synchronously.

    Use this when calling from synchronous code. This creates a new event loop and runs the server in it.

    Args:
        server: MCP server to run.
        transport: Transport protocol (http, stdio).
        stateless_http: If True, use stateless HTTP.
        port: Port to listen on.
        host: Host to listen on.
        path: Path to listen on.
        kwargs: Additional transport-specific arguments to pass to FastMCP.
    """
    server.run(transport=transport, stateless_http=stateless_http, port=port, host=host, path=path, **kwargs)