modex-bb.mcp.tools — io.github.hive-agi/modex-bb 0.1.3

Tool definition macros and utilities for Babashka MCP servers.

argmap clj

(argmap m)

Takes a {:keys [...]} argument map and extracts :type, :doc & :required to metadata.

deftools clj macro

(deftools name & tool-defs)

Calls tools and binds to a symbol via def.

extract-mcp-meta clj

(extract-mcp-meta m)

Extracts MCP tool metadata from a {:keys [...]} map.

handler clj macro

(handler [map-arg] & body)

Like fn but returns a fn with :mcp metadata for MCP Tool construction.

invoke-handler clj

(invoke-handler handler arg-map)

Invokes tool handler & arg-map. Returns result or throws on exception.

invoke-tool clj

(invoke-tool {:as tool :keys [handler args]} arg-map)

1. Validates tool input parameters (missing args or wrong types)
2. Calls invoke-tool-handler, gathers result
3. Returns {:keys [success results errors]}

ITool clj protocol

input-schema clj

(input-schema this)

required-args clj

(required-args this)

mcp-meta-keys clj

missing-elements clj

(missing-elements required input)

Returns seq of elements in required that are not present in input.

missing-tool-args clj

(missing-tool-args tool-args arg-map)

Returns a seq of missing args or nil, for args with :required true.

tool clj macro

(tool [tool-name & tool-body])

tool->json-schema clj

(tool->json-schema {:as tool :keys [name doc]})

Builds MCP-compatible {:keys [name description inputSchema]}.

tool-arg->property clj

(tool-arg->property tool-arg)

tool-args->input-schema clj

(tool-args->input-schema args)

tool-v1 clj macro

(tool-v1 [tool-name & tool-body])

Deprecated. Superseded by tool-v2-argmap, but still supported via tool.

tool-v2-argmap clj macro

(tool-v2-argmap [tool-name & tool-body])

Primary tool definition macro using map destructuring.

tools clj macro

(tools & tool-defs)

Returns a map of tool name => Tool.

validate-arg-types clj

(validate-arg-types args arg-map)

Validates argument types based on tool parameter definitions