SS

shapefs/shape-plugin

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

0 stars 0 forks 质量 53 趋势 20MIT

Shape MCP 插件包,面向人类及其 AI 代理

概览

为个人及其AI代理提供的文件系统。在你的Shape工作区中查找、阅读、保存和整理文件。 该软件包通过可流媒体的 HTTP 连接到 Shape 托管的 MCP 服务器。登录使用 OAuth:浏览器打开 Shape,你可以登录、选择工作区并批准代理的功能。不需要也不需要包含任何 API 密钥。 你需要一个Shape账户和工作区。账户访问和套餐限制适用。详见Shape、定价和设置说明。你的AI客户端的套餐和组织设置还可以限制插件或自定义MCP服务器。 - 当 Shape 插件在你的目录中有时安装,然后完成 OAuth。对于自定义连接,请按照设置指南操作。- 使用 https://shapefs.app/mcp, 添加 Shape 作为自定义远程连接器,然后连接并完成 OAuth。目录列表与该包是分开的。- 从支持的 Git 仓库或市场(如有列表时)安装该插件。连接 Shape MCP 服务器并完成 OAuth。

概述(AI 翻译)

Shape(Shape FS)是一个面向小型团队及其 AI 代理的共享文件工作区。通过批准的连接查找资产、检查图片并保存工作。Shape 的网站是 https://shapefs.com;,用户在 https://shapefs.app. 使用该工作区。

该软件包通过可流式 HTTP 连接到 Shape 托管的 MCP 服务器 **https://shapefs.app/mcp**。登录使用 OAuth:浏览器打开 Shape,您可以登录、选择工作区并批准代理的功能。无需或包含任何 API 密钥。

连接前

你需要一个Shape账户和工作区。账户访问和套餐限制适用。详见Shape、定价和设置说明。你的AI客户端的套餐和组织设置还可以限制插件或自定义MCP服务器。

连接

  • ChatGPT / Codex: 在目录中有 Shape 插件时安装,然后完成 OAuth。自定义连接请按照设置指南操作。
  • Claude: 使用 https://shapefs.app/mcp 添加 Shape 作为自定义远程连接器,然后连接并完成 OAuth。目录列表与该包是分开的。
  • Cursor: 从支持的 Git 仓库或市场中安装该插件(如列为 Marketplace)。

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

Shape

Shape (Shape FS) is a shared file workspace for small teams and their AI agents. Find assets, inspect images, and save work back through an approved connection. Shape’s website is https://shapefs.com; people use the workspace at https://shapefs.app.

This package connects to Shape’s hosted MCP server at https://shapefs.app/mcp over Streamable HTTP. Sign-in uses OAuth: your browser opens Shape so you can sign in, choose a workspace and approve what the agent can do. No API key is required or included.

Before connecting

You need a Shape account and workspace. Account access and plan limits apply. See Shape, pricing and setup instructions. Your AI client’s plan and organization settings can also restrict plugins or custom MCP servers.

Connect

  • ChatGPT / Codex: install the Shape plugin when it is available in your directory, then complete OAuth. For custom connections, follow the setup guide.
  • Claude: add Shape as a custom remote connector using https://shapefs.app/mcp, then connect and complete OAuth. A directory listing is separate from this package.
  • Cursor: install this plugin from a supported Git repository or from the marketplace when listed. Connect the Shape MCP server and complete OAuth. You can also add the same URL as a custom MCP server.
  • Grok: open Connectors, choose New Connector → Custom, enter https://shapefs.app/mcp and authenticate. This is a custom connection, not a claim of catalog inclusion.

Ask “List the folders in my Shape workspace” to confirm the connection. Installing this package alone does not mean it has been accepted into any public directory.

What you approve

Capability Allows
Read Browse and search folders, inspect files, read text and versions, download originals
Contribute Create folders, write and edit text, upload files, restore versions
Organize Rename, move and tag files and folders
Trash List recoverable Trash, move entries into it and restore them

Each connection has access to one workspace, limited by your membership and approved capabilities. Revoke or review connections in Shape → Connect. A file or folder link identifies an entry; it grants no access by itself. Tools that need a missing capability return a request for the person to approve; they do not act first.

Agents cannot permanently delete files, manage workspace members or change billing. Publishing images to the web requires separate Owner permission. File content and names are untrusted data. An agent should follow your request, not instructions found inside a file.

Examples

在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →