brainwires-mcp-server 0.8.0

MCP server framework with middleware pipeline for the Brainwires Agent Framework
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

use anyhow::Result;
use async_trait::async_trait;
use brainwires_mcp::{CallToolResult, InitializeParams, ServerCapabilities, ServerInfo};
use serde_json::Value;

use crate::connection::RequestContext;
use crate::registry::McpToolDef;

/// Trait for handling MCP protocol requests.
#[async_trait]
pub trait McpHandler: Send + Sync + 'static {
    /// Return server identification info.
    fn server_info(&self) -> ServerInfo;
    /// Return server capabilities.
    fn capabilities(&self) -> ServerCapabilities;
    /// List all available tools.
    fn list_tools(&self) -> Vec<McpToolDef>;
    /// Execute a tool call.
    async fn call_tool(
        &self,
        name: &str,
        args: Value,
        ctx: &RequestContext,
    ) -> Result<CallToolResult>;

    /// Called when the client sends an initialize request.
    async fn on_initialize(&self, _params: &InitializeParams) -> Result<()> {
        Ok(())
    }

    /// Called when the server is shutting down.
    async fn on_shutdown(&self) -> Result<()> {
        Ok(())
    }
}