Artifacta MCP Server 是 Artifacta 的官方 MCP 服务器。Artifacta 是专为 AI 智能体设计的制品存储服务，用于持久化、列出和交接运行输出，并附带会话元数据、去重和过期分享链接。该项目提供 TypeScript 与 Python 两种实现，二者的工具面、错误契约和路径限制引擎一致。
用途与定位
该服务器面向 AI 智能体场景，帮助智能体保存运行产物（文件、报告、数据集、构建结果等），并支持跨会话交接与分享。内容哈希去重意味着重新存储相同字节不会产生额外成本。
主要能力
- 持久化、列出、交接智能体的运行输出。
- 附带会话与智能体元数据。
- 内容哈希去重。
- 通过带过期时间的下载链接分享制品。
- 提供 MCP 资源，包括 whoami、制品元数据、制品字节和会话。
- 安全默认值：本地文件上传被限制在显式的 --allow-path 允许列表中；破坏性工具（公开分享链接、删除、会话封存）除非传入 --allow-destructive，否则对无法确认写入的客户端隐藏。publish_artifact 和 unpublish_artifact 是幂等写操作而非破坏性操作，不受 --allow-destructive 门控。
- 托管 OAuth 连接（mcp.artifacta.io）增加第二层控制：同意屏幕授予三种作用域之一——artifacts:read ⊆ artifacts:write ⊆ artifacts:destroy。工具列表始终展示全部 13 个工具；调用未授予权限的工具会返回错误，代码为 insufficient_scope 并指出缺失的作用域，解决方式是使用更宽作用域重新授权。作用域门控仅适用于托管 OAuth；ak_live_ API 密钥和本地 stdio 保持完全访问，改用 --allow-destructive / 确认标志。
使用方式
作为 Claude Code 插件安装
对于 Claude Code，最快的路径是使用该仓库同时兼作的插件市场——它会配置托管服务器以及一个自动持久化运行输出的技能：
这捆绑了与下文快速开始相同的托管 MCP 连接，外加 persisting-outputs 技能（/artifacta:persisting-outputs，或当会话中有值得保存的输出时自动触发）。使用 /plugin marketplace update artifacta 更新插件。参见插件设置指南。
快速开始（托管服务器）
最快的连接方式是托管服务器——无需安装、无需 API 密钥：
首次使用时，客户端通过 OAuth 动态客户端注册（PKCE）自行注册，并打开浏览器进行授权——无需复制或存储 ak_live_ 密钥。参见托管设置指南。
本地 / CI（stdio）
对于无法使用浏览器 OAuth 流程的无头、气隙或 CI 环境，可使用 API 密钥在本地通过 stdio 运行该包。在 app.artifacta.io/dashboard/keys 获取密钥，然后添加到 MCP 客户端配置（Claude Desktop、Claude Code、Cursor 或任何 MCP 客户端）：
或使用 pipx run artifacta-mcp 运行 Python 实现。
各包的 README 中包含配置文件配置、路径限制（--allow-path）、破坏性工具门控（--allow-destructive）和故障排除：TypeScript · Python。
框架集成
Python 包附带可选的适配器，用于 OpenAI Agents SDK（pip install 'artifacta-mcp[openai-agents]'）和 LangChain/LangGraph（pip install 'artifacta-mcp[langchain]'）。
完整文档见 docs.artifacta.io/mcp/overview。
该仓库从 Artifacta 单体仓库发布；欢迎在此提交问题和 PR。
MIT —— 见 LICENSE。
