Activitysmith

Servidor MCP de ActivitySmith

Este servidor MCP expone notificaciones de ActivitySmith y herramientas de actividad en vivo.

Configuración del cliente MCP (stdio)

Ejemplo de mcp.json:

{
	"mcpServers": {
		"activitysmith": {
			"command": "uv",
			"args": ["run", "mcp-activitysmith"],
			"env": {
				"API_KEY": "your_key_here"
			}
		}
	}
}

Ejemplo de mcp.json con prompt de entrada (VS Code):

{
	"inputs": [
		{
			"id": "activitysmithApiKey",
			"type": "promptString",
			"description": "ActivitySmith API key",
			"password": true
		}
	],
	"mcpServers": {
		"activitysmith": {
			"command": "uv",
			"args": ["run", "mcp-activitysmith"],
			"env": {
				"API_KEY": "${input:activitysmithApiKey}"
			}
		}
	}
}

Ejemplo de mcp.json usando Docker (stdio, imagen más reciente):

{
	"mcpServers": {
		"activitysmith": {
			"command": "docker",
			"args": [
				"run",
				"--rm",
				"-i",
				"-e",
				"API_KEY=your_key_here",
				"ghcr.io/stumpyfr/mcp-activitysmith:latest"
			]
		}
	}
}

Configuración del cliente MCP (HTTP)

Ejemplo de mcp.json:

{
	"mcpServers": {
		"activitysmith": {
			"url": "http://127.0.0.1:8000",
			"headers": {
				"Authorization": "Bearer your_key_here"
			}
		}
	}
}

Ejemplo de mcp.json con prompt de entrada (VS Code):

{
	"inputs": [
		{
			"id": "activitysmithApiKey",
			"type": "promptString",
			"description": "ActivitySmith API key",
			"password": true
		}
	],
	"mcpServers": {
		"activitysmith": {
			"url": "http://127.0.0.1:8000",
			"headers": {
				"Authorization": "Bearer ${input:activitysmithApiKey}"
			}
		}
	}
}

Requisitos de desarrollo

• Python 3.12+
• Clave de API de ActivitySmith

Instalación

uv sync

Si cambias el nombre del paquete o el punto de entrada, vuelve a ejecutar uv sync para actualizar el script.

Ejecución (stdio)

API_KEY=your_key_here uv run mcp-activitysmith

Ejecución (HTTP)

uv run mcp-activitysmith --server

Notas

• El modo HTTP lee la clave de API del encabezado Authorization en cada solicitud.
• El modo stdio lee la clave de API de la variable de entorno API_KEY.