THE ORIONIS API
Build with clarity.
Explore the building blocks of an async-first Python framework. Every module, class, and method — connected, searchable, and ready to build with.
class McpManager(IMcpManager): (source)
Constructor: McpManager(app, router, config, bus)
Own one compiled registry shared by native HTTP, STDIO, DI and the facade.
| Method | __init__ |
Capture application services without opening transports or performing I/O. |
| Method | _compile |
Validate and compile a server exactly once per application manager. |
| Async Method | _publish |
Scope events to a declaration already registered in this application. |
| Async Method | dispatch |
Use the same server and invoker reached by its local registration. |
| Method | finalize |
Index final fluent paths once at boot, preserving constant-time dispatch. |
| Method | get |
Return compiled local metadata by its configured handle. |
| Method | get |
Return compiled HTTP metadata by normalized native route path. |
| Method | local |
Register an explicit handle without accepting dynamic module imports. |
| Async Method | prompts |
Publish a prompt catalog change to the matching server's listeners. |
| Async Method | resources |
Publish a resource catalog change to the matching server's listeners. |
| Async Method | resource |
Publish one changed URI without resolving its content or identity. |
| Method | servers |
Return an immutable transport/address/declaration inventory. |
| Async Method | shutdown |
Wake subscriptions so their request owners can complete and clean up. |
| Async Method | start |
Serve only a configured local handle using native standard streams. |
| Async Method | tools |
Publish a catalog change without retaining the current identity. |
| Method | web |
Register one native POST endpoint with API authentication semantics. |
| Class Variable | __slots__ |
Declare the instance attribute slots reserved by this class. |
| Instance Variable | _app |
Application container supplying configuration and dependencies. |
| Instance Variable | _bus |
Value supplied for bus. |
| Instance Variable | _compiled |
Compiled server metadata indexed by the original server class. |
| Instance Variable | _config |
Validated configuration controlling this component. |
| Instance Variable | _local |
Compiled servers indexed by their local STDIO registration names. |
| Instance Variable | _router |
Value supplied for router. |
| Instance Variable | _web |
HTTP routes, compiled servers and transports indexed by endpoint path. |
IApplication, router: IRouter, config: McpConfig, bus: IMcpEventBus):
(source)
¶
Capture application services without opening transports or performing I/O.
| Parameters | |
app:orionis.IApplication | Application container supplying configuration and dependencies. |
router:orionis.http.routes.contracts.router.IRouter | Value supplied for router. |
config:orionis.mcp.config.McpConfig | Validated configuration controlling this component. |
bus:orionis.mcp.contracts.event_bus.IMcpEventBus | Value supplied for bus. |
| Returns | |
None | Complete the documented operation without returning a value. |
Validate and compile a server exactly once per application manager.
| Parameters | |
server:type[orionis.mcp.Server] | Value supplied for server. |
| Returns | |
orionis.mcp.server.compiler.CompiledMcpServer | Result of the operation described above. |
Scope events to a declaration already registered in this application.
| Parameters | |
server:type[orionis.mcp.Server] | Value supplied for server. |
method:str | Value supplied for method. |
uri:str | None | Value supplied for uri. |
| Returns | |
None | Complete the documented operation without returning a value. |
Use the same server and invoker reached by its local registration.
| Parameters | |
request:orionis.http.Request | Current request and its trusted execution context. |
| Returns | |
orionis.http.Response | Result of the operation described above. |
Index final fluent paths once at boot, preserving constant-time dispatch.
| Returns | |
None | Complete the documented operation without returning a value. |
Return compiled local metadata by its configured handle.
| Parameters | |
name:str | Value supplied for name. |
| Returns | |
orionis.mcp.server.compiler.CompiledMcpServer | Compiled local metadata by its configured handle. |
Return compiled HTTP metadata by normalized native route path.
| Parameters | |
path:str | Value supplied for path. |
| Returns | |
orionis.mcp.server.compiler.CompiledMcpServer | Compiled HTTP metadata by normalized native route path. |
Register an explicit handle without accepting dynamic module imports.
| Parameters | |
name:str | Value supplied for name. |
server:type[orionis.mcp.Server] | Value supplied for server. |
| Returns | |
None | Complete the documented operation without returning a value. |
Publish a prompt catalog change to the matching server's listeners.
| Parameters | |
server:type[orionis.mcp.Server] | Value supplied for server. |
| Returns | |
None | Complete the documented operation without returning a value. |
Publish a resource catalog change to the matching server's listeners.
| Parameters | |
server:type[orionis.mcp.Server] | Value supplied for server. |
| Returns | |
None | Complete the documented operation without returning a value. |
Publish one changed URI without resolving its content or identity.
| Parameters | |
server:type[orionis.mcp.Server] | Value supplied for server. |
uri:str | Value supplied for uri. |
| Returns | |
None | Complete the documented operation without returning a value. |
Wake subscriptions so their request owners can complete and clean up.
| Returns | |
None | Complete the documented operation without returning a value. |
Publish a catalog change without retaining the current identity.
| Parameters | |
server:type[orionis.mcp.Server] | Value supplied for server. |
| Returns | |
None | Complete the documented operation without returning a value. |
Register one native POST endpoint with API authentication semantics.
| Parameters | |
path:str | Fixed endpoint path without URI parameters, query strings or fragments. |
server:type[orionis.mcp.Server] | Server declaration to compile and bind to the endpoint. |
| Returns | |
orionis.http.routes.fluent.FluentRoute | API POST route bound to the server's HTTP transport. |
| Raises | |
TypeError | If the path is not a string or the declaration is not a Server subclass. |
ValueError | If the endpoint is invalid, already registered or its metadata is invalid. |