from typing import Literal
from fastmcp import Context
from mcp_jenkins.core.lifespan import jenkins
from mcp_jenkins.server import mcp
@mcp.tool(tags=['read'])
async def get_all_items(ctx: Context) -> list[dict]:
"""Get all items from Jenkins
Returns:
A list of items
"""
return [item.model_dump(exclude_none=True) for item in jenkins(ctx).get_items()]
@mcp.tool(tags=['read'])
async def get_item(ctx: Context, fullname: str) -> dict:
"""Get specific item from Jenkins
Args:
fullname: The fullname of the item
Returns:
The item
"""
return jenkins(ctx).get_item(fullname=fullname).model_dump(exclude_none=True)
@mcp.tool(tags=['read'])
async def get_item_config(ctx: Context, fullname: str) -> str:
"""Get specific item config from Jenkins
Args:
fullname: The fullname of the item
Returns:
The config of the item
"""
return jenkins(ctx).get_item_config(fullname=fullname)
@mcp.tool(tags=['read'])
async def query_items(
ctx: Context,
class_pattern: str = None,
fullname_pattern: str = None,
color_pattern: str = None,
) -> list[dict]:
"""Query items from Jenkins
Args:
class_pattern: The pattern of the _class
fullname_pattern: The pattern of the fullname
color_pattern: The pattern of the color
Returns:
A list of items
"""
return [
item.model_dump(exclude_none=True)
for item in jenkins(ctx).query_items(
class_pattern=class_pattern,
fullname_pattern=fullname_pattern,
color_pattern=color_pattern,
)
]
@mcp.tool(tags=['write'])
async def build_item(
ctx: Context, fullname: str, build_type: Literal['build', 'buildWithParameters'], params: dict = None
) -> int:
"""Build an item in Jenkins
Args:
fullname: The fullname of the item
params: Update the default parameters of the item.
build_type: If your item is configured with parameters, you must use 'buildWithParameters' as build_type.
Returns:
The queue item number of the item.
"""
return jenkins(ctx).build_item(fullname=fullname, build_type=build_type, params=params)
