MCP Server

The MCP (Model Context Protocol) server module enables AI assistants to interact with Kumiho Cloud.

For usage documentation, see MCP Server Integration.

Kumiho MCP Server - Model Context Protocol integration for Kumiho Cloud.

This module provides an MCP (Model Context Protocol) server that exposes Kumiho Cloud functionality to AI assistants like GitHub Copilot, Claude, and other MCP-compatible clients.

The server enables AI assistants to: - Query and navigate asset graphs - Analyze dependencies and impact - Search for items across projects - Track AI lineage and provenance - Manage revisions and artifacts

Usage:

Run as a standalone server:

python -m kumiho.mcp_server

Or use the CLI entry point:

kumiho-mcp
Configuration:

The MCP server uses the same authentication as the Kumiho SDK. Run kumiho-auth login first to cache credentials.

Environment Variables:

KUMIHO_MCP_LOG_LEVEL: Log level (DEBUG, INFO, WARNING, ERROR). Default: INFO

Example MCP client configuration (VS Code settings.json):

{
    "mcp": {
        "servers": {
            "kumiho": {
                "command": "kumiho-mcp"
            }
        }
    }
}
kumiho.mcp_server.tool_list_projects()[source]

List all projects accessible to the current user.

Return type:

Dict[str, Any]

kumiho.mcp_server.tool_get_project(name)[source]

Get a project by name.

Return type:

Dict[str, Any]

Parameters:

name (str)

kumiho.mcp_server.tool_get_spaces(project_name, recursive=False)[source]

Get spaces within a project.

Return type:

Dict[str, Any]

Parameters:

  • project_name (str)

  • recursive (bool)

kumiho.mcp_server.tool_get_space(space_path)[source]

Get a space by its path.

Return type:

Dict[str, Any]

Parameters:

space_path (str)

kumiho.mcp_server.tool_get_item(kref)[source]

Get an item by its kref URI.

Return type:

Dict[str, Any]

Parameters:

kref (str)

kumiho.mcp_server.tool_get_revision(kref)[source]

Get a revision by its kref URI.

Return type:

Dict[str, Any]

Parameters:

kref (str)

kumiho.mcp_server.tool_get_artifacts(revision_kref)[source]

Get all artifacts for a revision.

Return type:

Dict[str, Any]

Parameters:

revision_kref (str)

kumiho.mcp_server.tool_get_artifact(artifact_kref)[source]

Get a single artifact by its kref URI.

Return type:

Dict[str, Any]

Parameters:

artifact_kref (str)

kumiho.mcp_server.tool_get_bundle(bundle_kref)[source]

Get a bundle by its kref URI.

Return type:

Dict[str, Any]

Parameters:

bundle_kref (str)

kumiho.mcp_server.tool_search_items(context_filter='', name_filter='', kind_filter='')[source]

Search for items across projects and spaces.

Return type:

Dict[str, Any]

Parameters:

  • context_filter (str)

  • name_filter (str)

  • kind_filter (str)

kumiho.mcp_server.tool_get_dependencies(revision_kref, max_depth=5, edge_types=None)[source]

Get all dependencies of a revision (what it depends on).

Return type:

Dict[str, Any]

Parameters:

  • revision_kref (str)

  • max_depth (int)

  • edge_types (List[str] | None)

kumiho.mcp_server.tool_get_dependents(revision_kref, max_depth=5, edge_types=None)[source]

Get all dependents of a revision (what depends on it).

Return type:

Dict[str, Any]

Parameters:

  • revision_kref (str)

  • max_depth (int)

  • edge_types (List[str] | None)

kumiho.mcp_server.tool_analyze_impact(revision_kref, max_depth=10, edge_types=None)[source]

Analyze the impact of changes to a revision.

Return type:

Dict[str, Any]

Parameters:

  • revision_kref (str)

  • max_depth (int)

  • edge_types (List[str] | None)

kumiho.mcp_server.tool_find_path(source_kref, target_kref, max_depth=10, edge_types=None)[source]

Find the shortest path between two revisions.

Return type:

Dict[str, Any]

Parameters:

  • source_kref (str)

  • target_kref (str)

  • max_depth (int)

  • edge_types (List[str] | None)

kumiho.mcp_server.tool_get_edges(revision_kref, direction='both', edge_type=None)[source]

Get edges for a revision.

Return type:

Dict[str, Any]

Parameters:

  • revision_kref (str)

  • direction (str)

  • edge_type (str | None)

kumiho.mcp_server.tool_resolve_kref(kref)[source]

Resolve a kref URI to a file location.

Return type:

Dict[str, Any]

Parameters:

kref (str)

kumiho.mcp_server.tool_get_artifacts_by_location(location)[source]

Find all artifacts at a specific file location (reverse lookup).

Return type:

Dict[str, Any]

Parameters:

location (str)

kumiho.mcp_server.tool_get_item_revisions(item_kref)[source]

Get all revisions for an item.

Return type:

Dict[str, Any]

Parameters:

item_kref (str)

kumiho.mcp_server.tool_get_revision_by_tag(item_kref, tag)[source]

Get a revision by tag (e.g., ‘latest’, ‘published’, ‘approved’).

Return type:

Dict[str, Any]

Parameters:
kumiho.mcp_server.tool_create_revision(item_kref, metadata=None)[source]

Create a new revision for an item.

Return type:

Dict[str, Any]

Parameters:
kumiho.mcp_server.tool_tag_revision(revision_kref, tag)[source]

Apply a tag to a revision.

Return type:

Dict[str, Any]

Parameters:

  • revision_kref (str)

  • tag (str)

kumiho.mcp_server.tool_create_edge(source_kref, target_kref, edge_type, metadata=None)[source]

Create an edge between two revisions.

Return type:

Dict[str, Any]

Parameters:
kumiho.mcp_server.tool_create_project(name, description='', allow_public=False)[source]

Create a new Kumiho project.

Return type:

Dict[str, Any]

Parameters:

  • name (str)

  • description (str)

  • allow_public (bool)

kumiho.mcp_server.tool_create_space(project_name, space_name, parent_path=None)[source]

Create a new space within a project.

Return type:

Dict[str, Any]

Parameters:

  • project_name (str)

  • space_name (str)

  • parent_path (str | None)

kumiho.mcp_server.tool_create_item(space_path, item_name, kind, metadata=None)[source]

Create a new item within a space.

Return type:

Dict[str, Any]

Parameters:
kumiho.mcp_server.tool_create_artifact(revision_kref, name, location)[source]

Create an artifact for a revision.

Return type:

Dict[str, Any]

Parameters:

  • revision_kref (str)

  • name (str)

  • location (str)

kumiho.mcp_server.tool_create_bundle(space_path, bundle_name, metadata=None)[source]

Create a new bundle within a space.

Return type:

Dict[str, Any]

Parameters:
kumiho.mcp_server.tool_delete_project(project_name, force=False)[source]

Delete a project.

Return type:

Dict[str, Any]

Parameters:
kumiho.mcp_server.tool_delete_space(space_path, force=False)[source]

Delete a space.

Return type:

Dict[str, Any]

Parameters:
kumiho.mcp_server.tool_delete_item(item_kref, force=False)[source]

Delete an item.

Return type:

Dict[str, Any]

Parameters:
kumiho.mcp_server.tool_delete_revision(revision_kref)[source]

Delete a revision.

Return type:

Dict[str, Any]

Parameters:

revision_kref (str)

kumiho.mcp_server.tool_delete_artifact(artifact_kref)[source]

Delete an artifact.

Return type:

Dict[str, Any]

Parameters:

artifact_kref (str)

kumiho.mcp_server.tool_delete_edge(source_kref, target_kref, edge_type)[source]

Delete an edge between two revisions.

Return type:

Dict[str, Any]

Parameters:

  • source_kref (str)

  • target_kref (str)

  • edge_type (str)

kumiho.mcp_server.tool_untag_revision(revision_kref, tag)[source]

Remove a tag from a revision.

Return type:

Dict[str, Any]

Parameters:

  • revision_kref (str)

  • tag (str)

kumiho.mcp_server.tool_set_metadata(kref, metadata)[source]

Set metadata on an item or revision.

Return type:

Dict[str, Any]

Parameters:
kumiho.mcp_server.tool_deprecate_item(item_kref, deprecated=True)[source]

Set the deprecated status of an item.

Return type:

Dict[str, Any]

Parameters:

  • item_kref (str)

  • deprecated (bool)

kumiho.mcp_server.tool_add_bundle_member(bundle_kref, item_kref)[source]

Add an item to a bundle.

Return type:

Dict[str, Any]

Parameters:

  • bundle_kref (str)

  • item_kref (str)

kumiho.mcp_server.tool_remove_bundle_member(bundle_kref, item_kref)[source]

Remove an item from a bundle.

Return type:

Dict[str, Any]

Parameters:

  • bundle_kref (str)

  • item_kref (str)

kumiho.mcp_server.tool_get_bundle_members(bundle_kref)[source]

Get all members of a bundle.

Return type:

Dict[str, Any]

Parameters:

bundle_kref (str)

kumiho.mcp_server.create_mcp_server()[source]

Create and configure the Kumiho MCP server.

Return type:

Server

async kumiho.mcp_server.run_server()[source]

Run the MCP server.

Return type:

None

kumiho.mcp_server.main()[source]

Entry point for the MCP server CLI.

Return type:

None

Tool Definitions

The MCP server exposes 39 tools for interacting with Kumiho Cloud:

Read Operations:

  • kumiho_list_projects - List all accessible projects

  • kumiho_get_project - Get project by name

  • kumiho_get_spaces - Get spaces in a project

  • kumiho_get_space - Get a space by path

  • kumiho_get_item - Get item by kref

  • kumiho_search_items - Search items with filters

  • kumiho_get_item_revisions - Get all revisions for an item

  • kumiho_get_revision - Get revision by kref

  • kumiho_get_revision_by_tag - Get revision by tag

  • kumiho_get_artifacts - Get artifacts for a revision

  • kumiho_get_artifact - Get artifact by kref

  • kumiho_get_bundle - Get bundle by kref

  • kumiho_resolve_kref - Resolve kref to file location

  • kumiho_get_artifacts_by_location - Reverse lookup by file path

Graph Operations:

  • kumiho_get_dependencies - Get what a revision depends on

  • kumiho_get_dependents - Get what depends on a revision

  • kumiho_analyze_impact - Analyze downstream impact

  • kumiho_find_path - Find path between revisions

  • kumiho_get_edges - Get edges for a revision

Create Operations:

  • kumiho_create_project - Create a new project

  • kumiho_create_space - Create a space

  • kumiho_create_item - Create an item

  • kumiho_create_revision - Create a revision

  • kumiho_create_artifact - Create an artifact

  • kumiho_create_bundle - Create a bundle

  • kumiho_create_edge - Create a relationship

  • kumiho_tag_revision - Tag a revision

Delete Operations:

  • kumiho_delete_project - Delete a project

  • kumiho_delete_space - Delete a space

  • kumiho_delete_item - Delete an item

  • kumiho_delete_revision - Delete a revision

  • kumiho_delete_artifact - Delete an artifact

  • kumiho_delete_edge - Delete a relationship

Update Operations:

  • kumiho_untag_revision - Remove a tag

  • kumiho_set_metadata - Set metadata

  • kumiho_deprecate_item - Deprecate an item

  • kumiho_add_bundle_member - Add item to bundle

  • kumiho_remove_bundle_member - Remove item from bundle

  • kumiho_get_bundle_members - List bundle members