Skip to main content

Crate kotoba

Crate kotoba 

Source
Expand description

Kotoba (言葉) — MCP server framework for pleme-io applications.

Shared boilerplate and helpers for building MCP servers with rmcp:

  • McpApp: server builder with sensible defaults (name, version, stdio)
  • json_ok / json_err: consistent JSON response formatting
  • StatusTool: standardized health/status tool (name, version, uptime)
  • Re-exports of rmcp types used in every MCP server

§Usage

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(&result)
    }
}

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

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

Re-exports§

pub use error::McpError;
pub use response::json_err;
pub use response::json_ok;
pub use response::json_result;
pub use status::StatusInfo;

Modules§

error
prelude
response
status

Functions§

run
Run an MCP server on stdio transport. Standard entry point for all pleme-io MCP servers.
server_info
Create a ServerInfo with tools enabled and the given name + description.