Activitysmith

Servidor MCP do ActivitySmith

Este servidor MCP expõe notificações do ActivitySmith e ferramentas de atividade em tempo real.

Configuração do Cliente MCP (stdio)

Exemplo de mcp.json:

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

Exemplo de mcp.json com 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}"
			}
		}
	}
}

Exemplo de mcp.json usando Docker (stdio, imagem mais recente):

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

Configuração do Cliente MCP (HTTP)

Exemplo de mcp.json:

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

Exemplo de mcp.json com 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 desenvolvimento

• Python 3.12+
• Chave da API do ActivitySmith

Instalação

uv sync

Se você alterar o nome do pacote ou o ponto de entrada, execute novamente uv sync para atualizar o script.

Execução (stdio)

API_KEY=your_key_here uv run mcp-activitysmith

Execução (HTTP)

uv run mcp-activitysmith --server

Observações

• O modo HTTP lê a chave da API do cabeçalho Authorization em cada solicitação.
• O modo stdio lê a chave da API da variável de ambiente API_KEY.