kotoha 0.1.1

Kotoba (言葉) — MCP server framework: shared boilerplate, helpers, and patterns for rmcp
Documentation

Kotoba (言葉)

MCP server framework for pleme-io applications. Eliminates boilerplate when building MCP servers with rmcp.

What It Provides

Module Purpose
prelude Re-exports all rmcp types needed in every MCP server
response json_ok, json_err, json_result — consistent JSON formatting
status StatusInfo, UptimeTracker — standardized health tool
error McpError — common error type with JSON serialization
server_info() Create ServerInfo with tools enabled
run() Standard stdio server entry point

Usage

[dependencies]
kotoba = { git = "https://github.com/pleme-io/kotoba" }

use kotoba::prelude::*;

#[derive(Clone)]
struct MyServer { tool_router: ToolRouter<Self> }

#[tool_router]
impl MyServer {
    #[tool(description = "do something")]
    async fn my_tool(&self, Parameters(input): Parameters<MyInput>) -> String {
        json_ok(&serde_json::json!({"result": "done"}))
    }
}

#[tool_handler]
impl ServerHandler for MyServer {
    fn get_info(&self) -> ServerInfo {
        kotoba::server_info("my-app", "My app does things")
    }
}

#[tokio::main]
async fn main() {
    kotoba::run(MyServer::new()).await.unwrap();
}

Before/After

Before (every project):

use rmcp::{ServerHandler, ServiceExt, handler::server::..., model::..., ...};
fn json_err(e: impl Display) -> String { format!(r#"{{"error":"{}"}}"#, ...) }
pub async fn run() -> Result<...> {
    let server = MyServer::new().serve(stdio()).await?;
    server.waiting().await?;
    Ok(())
}

After (with kotoba):

use kotoba::prelude::*;
// json_ok, json_err, json_result, all rmcp types — already imported

Build

cargo build
cargo test --lib