convez.ai
MCP ServerIntegração & APIsIntermediário
SagaPeak

Artifacta MCP Server

SagaPeak/artifacta-mcp

Persistência e compartilhamento de artefatos para agentes IA com dedup e links temporários

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP oficial para Artifacta, um armazenamento de artefatos propositalmente construído para agentes de IA. Permite persistir outputs de execuções (arquivos, relatórios, datasets, resultados de build) com metadados de sessão e agente, repassá-los entre sessões e compartilhá-los via links de download com expiração. Implementações em TypeScript e Python com deduplicação por hash de conteúdo.

Instalação

$npx convez-ai SagaPeak/artifacta-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
50%
Último commit
há 3 meses
Versão
v1.0.2
Issues abertas
0
Contribuidores
1

Casos de uso

  • Persistir outputs de agentes entre sessões e contextos
  • Compartilhar resultados de execução via links públicos com expiração
  • Gerenciar metadata de sessões e agentes em pipelines automatizados
  • Reutilizar artefatos com deduplicação por conteúdo

Veredito

MCP server robusto e bem mantido, oficial do Artifacta, com suporte dual TypeScript/Python e recursos de segurança (path confinement, gating de operações destrutivas). Ideal para arquiteturas de agentes que precisam persistir e compartilhar artefatos com controle fino de acesso.

README

A tradução para o português deste README ainda está na fila.

Artifacta MCP Server

npm PyPI License: MIT

Official MCP server for Artifacta — an artifact store purpose-built for AI agents. Agents persist run outputs (files, reports, datasets, build results) with session and agent metadata, hand them off across sessions, and share them via expiring download links. Content-hash dedup means re-storing the same bytes is free.

Listed in the official MCP registry as io.artifacta/mcp.

Two implementations with the same tool surface, error contract, and path-confinement engine:

DirectoryPackageRuntime
typescript/@artifacta-mcp/mcpNode 20+
python/artifacta-mcpPython 3.10+

Quick start

Get an API key at app.artifacta.io/dashboard/keys, then add to your MCP client config (Claude Desktop, Claude Code, Cursor, or any MCP client):

{
  "mcpServers": {
    "artifacta": {
      "command": "npx",
      "args": ["-y", "@artifacta-mcp/mcp"],
      "env": {
        "ARTIFACTA_API_KEY": "ak_live_..."
      }
    }
  }
}

Or run the Python implementation with pipx run artifacta-mcp.

See the per-package READMEs for config-file profiles, path confinement (--allow-path), destructive-tool gating (--allow-destructive), and troubleshooting: TypeScript · Python.

Tools

ToolDescription
whoamiVerify credentials; returns tenant and plan info
store_artifactUpload an artifact from inline content or a local path
request_upload_url / complete_uploadTwo-phase presigned upload for large files
get_artifactFetch artifact metadata by ID
get_artifact_download_urlGet a presigned download URL (1h expiry)
list_artifactsList/filter artifacts by session, agent, or metadata
list_sessionsList active sessions
seal_sessionSeal a session so no further artifacts can be added
create_download_linkCreate a public expiring share link (gated behind --allow-destructive)
delete_artifactSoft-delete an artifact (gated behind write confirmation)

Plus MCP resources for whoami, artifact metadata, artifact bytes, and sessions.

Safety defaults: local-file uploads are confined to an explicit --allow-path allow-list, and destructive tools (public share links, deletes, session seals) are hidden from clients that can't confirm writes unless --allow-destructive is passed.

Framework integrations

The Python package ships optional adapters for OpenAI Agents SDK (pip install 'artifacta-mcp[openai-agents]') and LangChain/LangGraph (pip install 'artifacta-mcp[langchain]').

Documentation

Full docs at docs.artifacta.io/mcp/overview.

Development

# TypeScript
cd typescript && npm install && npm test

# Python
cd python && python -m venv .venv && source .venv/bin/activate
pip install -e '.[dev]' && pytest

This repository is published from the Artifacta monorepo; issues and PRs are welcome here.

License

MIT — see LICENSE.

Ver o original no GitHub

Bom para

Relacionados