selfware 0.6.0

Your personal AI workshop — software you own, software that lasts
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
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58

//! Model Context Protocol (MCP) client implementation.
//!
//! Enables Selfware to connect to MCP servers (GitHub, Playwright, databases, etc.)
//! and use their tools as native tools in the agent's tool registry.
//!
//! MCP uses JSON-RPC 2.0 over stdio transport. Each server is a child process
//! that communicates via stdin/stdout.

pub mod client;
pub mod discovery;
pub mod server;
pub mod tool_bridge;
pub mod transport;

pub use client::McpClient;
pub use discovery::discover_tools;
pub use tool_bridge::McpTool;
pub use transport::{Framing, StdioTransport, Transport};

use serde::{Deserialize, Serialize};

/// Configuration for a single MCP server.
#[derive(Debug, Clone, Serialize, Deserialize)]
pub struct McpServerConfig {
    /// Human-readable name for this server.
    pub name: String,
    /// Command to spawn the server process.
    pub command: String,
    /// Arguments to pass to the command.
    #[serde(default)]
    pub args: Vec<String>,
    /// Environment variables to set for the server process.
    #[serde(default)]
    pub env: std::collections::HashMap<String, String>,
    /// Timeout in seconds for server initialization (default: 30).
    #[serde(default = "default_init_timeout")]
    pub init_timeout_secs: u64,
    /// Wire framing for this server's stdio protocol
    /// (default: newline-delimited per the MCP spec).
    #[serde(default)]
    pub framing: Framing,
}

fn default_init_timeout() -> u64 {
    30
}

/// Top-level MCP configuration section.
#[derive(Debug, Clone, Default, Serialize, Deserialize)]
pub struct McpConfig {
    /// List of MCP servers to connect to.
    #[serde(default)]
    pub servers: Vec<McpServerConfig>,
}

#[cfg(test)]
#[path = "../../tests/unit/mcp/mod_test.rs"]
mod tests;