UGT: Use the GitHub Thing
Get open-source GitHub projects running on your computer, with your AI app
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"ugt": {
"command": "uvx",
"args": [
"https://github.com/auscaster/ugt/releases/download/v0.3.0/ugt-mcp-darwin-arm64.mcpb"
]
}
}
}Runnable packages
0.3.0stdio0.3.0stdio0.3.0stdio0.3.0stdio0.3.0stdio0.3.0stdioRemote endpoints
https://mcp.usegithubthing.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (5)
🟢search_recipes(query, limit)
Find how UGT gets a job done on the user's own computer with open-source software from GitHub, such as subtitles, CAD, video or web pages to Markdown. Search by what the user wants done or by a project's name, or omit the query to list the newest recipes. A recipe is a verified way to get one project doing one job, shared so the next person gets it fast.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "What the user wants done, or a project's name. Omit to list the newest recipes."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 50,
"description": "Maximum results to return; defaults to 20."
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"recipes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"recipe": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}\\/[A-Za-z0-9][A-Za-z0-9._-]{0,99}\\/[A-Za-z0-9][A-Za-z0-9._-]{0,99}$",
"description": "A recipe's ID, owner/repo/task, such as openai/whisper/subtitles."
},
"project": {
"type": "string",
"description": "The GitHub project, owner/repo."
},
"task": {
"type": "string",
"minLength": 1,
"description": "What the recipe does."
},
"kind": {
"type": "string",
"enum": [
"job",
"service"
],
"description": "job: runs once on the user's files and hands over the result. service: keeps running until stopped, with pages, endpoints, commands or MCP servers to use."
},
"page_url": {
"type": "string",
"format": "uri",
"description": "The recipe's page on usegeekthing.com, with its Open in UGT button and the line that installs UGT."
},
"open_in_ugt": {
"type": "string",
"format": "starts_with",
"pattern": "^ugt:\\/\\/run\\/.*",
"description": "Opens the recipe in UGT on the user's computer, which shows what it runs, gives and can reach. Nothing runs until they press Run."
},
"command": {
"type": "string",
"description": "The same in a terminal, once UGT is installed."
}
},
"required": [
"recipe",
"project",
"task",
"kind",
"page_url",
"open_in_ugt",
"command"
],
"additionalProperties": false
}
}
},
"required": [
"recipes"
],
"additionalProperties": false
}🟢get_project(project)
Get how UGT runs one GitHub project, by owner/repo or its link: the recipes people have shared for it, each verified for one job. Every GitHub project works with UGT, so the result always says what to do next.
Input Schema
{
"type": "object",
"properties": {
"project": {
"type": "string",
"minLength": 3,
"maxLength": 300,
"description": "The GitHub project as owner/repo, such as openai/whisper, or its GitHub link."
}
},
"required": [
"project"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"project": {
"type": "string",
"description": "The project, owner/repo."
},
"page_url": {
"type": "string",
"format": "uri",
"description": "The project's page on usegeekthing.com."
},
"recipes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"recipe": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}\\/[A-Za-z0-9][A-Za-z0-9._-]{0,99}\\/[A-Za-z0-9][A-Za-z0-9._-]{0,99}$",
"description": "A recipe's ID, owner/repo/task, such as openai/whisper/subtitles."
},
"project": {
"type": "string",
"description": "The GitHub project, owner/repo."
},
"task": {
"type": "string",
"minLength": 1,
"description": "What the recipe does."
},
"kind": {
"type": "string",
"enum": [
"job",
"service"
],
"description": "job: runs once on the user's files and hands over the result. service: keeps running until stopped, with pages, endpoints, commands or MCP servers to use."
},
"page_url": {
"type": "string",
"format": "uri",
"description": "The recipe's page on usegeekthing.com, with its Open in UGT button and the line that installs UGT."
},
"open_in_ugt": {
"type": "string",
"format": "starts_with",
"pattern": "^ugt:\\/\\/run\\/.*",
"description": "Opens the recipe in UGT on the user's computer, which shows what it runs, gives and can reach. Nothing runs until they press Run."
},
"command": {
"type": "string",
"description": "The same in a terminal, once UGT is installed."
}
},
"required": [
"recipe",
"project",
"task",
"kind",
"page_url",
"open_in_ugt",
"command"
],
"additionalProperties": false
}
},
"next": {
"type": "string",
"description": "What the user can do next."
}
},
"required": [
"project",
"page_url",
"recipes",
"next"
],
"additionalProperties": false
}🟢get_recipe(recipe)
Get one recipe in full: what it takes and makes, what stays usable after a run, the settings it asks for, everything it can reach and why, where it was tested, and every file it runs.
Input Schema
{
"type": "object",
"properties": {
"recipe": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}\\/[A-Za-z0-9][A-Za-z0-9._-]{0,99}\\/[A-Za-z0-9][A-Za-z0-9._-]{0,99}$",
"description": "A recipe's ID, owner/repo/task, such as openai/whisper/subtitles."
}
},
"required": [
"recipe"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"recipe": {
"type": "object",
"properties": {
"recipe": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}\\/[A-Za-z0-9][A-Za-z0-9._-]{0,99}\\/[A-Za-z0-9][A-Za-z0-9._-]{0,99}$",
"description": "A recipe's ID, owner/repo/task, such as openai/whisper/subtitles."
},
"project": {
"type": "string",
"description": "The GitHub project, owner/repo."
},
"task": {
"type": "string",
"minLength": 1,
"description": "What the recipe does."
},
"kind": {
"type": "string",
"enum": [
"job",
"service"
],
"description": "job: runs once on the user's files and hands over the result. service: keeps running until stopped, with pages, endpoints, commands or MCP servers to use."
},
"page_url": {
"type": "string",
"format": "uri",
"description": "The recipe's page on usegeekthing.com, with its Open in UGT button and the line that installs UGT."
},
"open_in_ugt": {
"type": "string",
"format": "starts_with",
"pattern": "^ugt:\\/\\/run\\/.*",
"description": "Opens the recipe in UGT on the user's computer, which shows what it runs, gives and can reach. Nothing runs until they press Run."
},
"command": {
"type": "string",
"description": "The same in a terminal, once UGT is installed."
},
"licence": {
"type": "string",
"description": "The project's licence."
},
"source_url": {
"type": "string",
"format": "uri",
"description": "The project on GitHub, at the exact commit the recipe runs."
},
"revision": {
"type": "string",
"description": "The recipe's revision served now."
},
"takes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"path": {
"type": "string"
},
"what": {
"type": "string"
}
},
"required": [
"path",
"what"
],
"additionalProperties": false
},
"description": "The files the user gives it, each placed at its path."
},
"makes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"path": {
"type": "string"
},
"what": {
"type": "string"
}
},
"required": [
"path",
"what"
],
"additionalProperties": false
},
"description": "The files it delivers, to the user's UGT folder, in UGT/<owner>/<repo>/<task>."
},
"provides": {
"type": "object",
"properties": {
"pages": {
"type": "array",
"items": {
"type": "string"
}
},
"endpoints": {
"type": "array",
"items": {
"type": "string"
}
},
"commands": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"what": {
"type": "string"
}
},
"required": [
"name",
"what"
],
"additionalProperties": false
}
},
"mcp_servers": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"pages",
"endpoints",
"commands",
"mcp_servers"
],
"additionalProperties": false,
"description": "What stays usable after a run: pages and endpoints at 127.0.0.1 on the user's computer, commands on their PATH, and MCP servers whose tools join UGT's in their AI app."
},
"asks_for": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"what": {
"type": "string"
}
},
"required": [
"name",
"what"
],
"additionalProperties": false
},
"description": "Settings the user gives UGT, such as an API key. UGT asks for a secret in its own dialog on the user's screen, never in chat."
},
"reaches": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string"
},
"name": {
"type": "string"
},
"why": {
"type": "string"
}
},
"required": [
"kind",
"name",
"why"
],
"additionalProperties": false
},
"description": "What it can reach beyond the files it is given, and why. Empty when it reaches only those files, with no network."
},
"tested": {
"type": "array",
"items": {
"type": "object",
"properties": {
"arch": {
"type": "string",
"enum": [
"amd64",
"arm64"
]
},
"at": {
"type": "string"
}
},
"required": [
"arch",
"at"
],
"additionalProperties": false
},
"description": "Its verification on clean machines before it was admitted, by processor (amd64 for a PC or Intel Mac, arm64 for Apple silicon or Arm): its check passed on its sample and failed on broken results. A recipe runs the same way on Windows, Mac and Linux, in UGT's Linux engine."
},
"ready_built": {
"type": "boolean",
"description": "true: UGT pulls the image it verified, ready-built. false: UGT builds what the recipe builds on the user's computer, exactly as it was verified, and pulls any upstream images it names by digest."
},
"files": {
"type": "array",
"items": {
"type": "object",
"properties": {
"path": {
"type": "string"
},
"size": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"url": {
"type": "string",
"format": "uri"
}
},
"required": [
"path",
"size",
"url"
],
"additionalProperties": false
},
"description": "Every file of the recipe."
},
"files_url": {
"type": "string",
"format": "uri",
"description": "The recipe's folder in UGT's public repository."
}
},
"required": [
"recipe",
"project",
"task",
"kind",
"page_url",
"open_in_ugt",
"command",
"licence",
"source_url",
"revision",
"takes",
"makes",
"provides",
"asks_for",
"reaches",
"tested",
"ready_built",
"files",
"files_url"
],
"additionalProperties": false
}
},
"required": [
"recipe"
],
"additionalProperties": false
}🟢read_recipe_file(recipe, path)
Read one of a recipe's files, such as compose.yaml, its Dockerfile or recipe.json, to see exactly what it runs.
Input Schema
{
"type": "object",
"properties": {
"recipe": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}\\/[A-Za-z0-9][A-Za-z0-9._-]{0,99}\\/[A-Za-z0-9][A-Za-z0-9._-]{0,99}$",
"description": "A recipe's ID, owner/repo/task, such as openai/whisper/subtitles."
},
"path": {
"type": "string",
"minLength": 1,
"maxLength": 300,
"description": "The file's path in the recipe, as the recipe lists it."
}
},
"required": [
"recipe",
"path"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"recipe": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9._-]{0,99}\\/[A-Za-z0-9][A-Za-z0-9._-]{0,99}\\/[A-Za-z0-9][A-Za-z0-9._-]{0,99}$",
"description": "A recipe's ID, owner/repo/task, such as openai/whisper/subtitles."
},
"revision": {
"type": "string"
},
"path": {
"type": "string"
},
"size": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"text": {
"type": "string"
}
},
"required": [
"recipe",
"revision",
"path",
"size",
"text"
],
"additionalProperties": false
}🟢get_install(computer)
Get the one line that installs UGT on the user's Windows PC, Mac or Linux computer and connects it to their AI apps, UGT for Claude Desktop, and what each computer runs recipes in. Omit the computer to get every one.
Input Schema
{
"type": "object",
"properties": {
"computer": {
"type": "string",
"enum": [
"mac-apple-silicon",
"mac-intel",
"windows",
"windows-arm",
"linux",
"linux-arm"
],
"description": "The user's computer. Omit to get every one."
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"computers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"computer": {
"type": "string",
"enum": [
"mac-apple-silicon",
"mac-intel",
"windows",
"windows-arm",
"linux",
"linux-arm"
]
},
"name": {
"type": "string"
},
"paste_in": {
"type": "string",
"enum": [
"Terminal",
"PowerShell"
],
"description": "Where to paste the install line."
},
"install": {
"type": "string",
"description": "The one line that installs UGT and runs its setup."
},
"claude_desktop": {
"type": "string",
"format": "uri",
"description": "UGT for Claude Desktop on this computer: download it and open it, and Claude Desktop installs it in one click."
},
"package_manager": {
"type": "string",
"description": "The same through a package manager, which keeps ugt current itself."
},
"engine": {
"type": "string",
"description": "The Linux engine UGT runs recipes in, on this computer."
}
},
"required": [
"computer",
"name",
"paste_in",
"install",
"package_manager",
"engine"
],
"additionalProperties": false
}
},
"setup": {
"type": "string",
"description": "What the install line does."
},
"next": {
"type": "string",
"description": "What the user does next."
}
},
"required": [
"computers",
"setup",
"next"
],
"additionalProperties": false
}Community
Evidence