518.PLUS

功能介绍

发现	浏览市场，或使用 MCP 列出和搜索工具、查看其输入和价格。
运行	通过 MCP、网页或 /v1 使用工具。根据每个工具的声明，结果可以是文本、JSON 或文件。
分享	发送结果页面或文件链接。文件链接设有有效期和下载次数限制。
发布	注册一个符合工具契约的 HTTPS 端点。新工具默认不公开；成功运行一次后，即可将其公开。付费调用可为提供方带来分成。

连接你的 Agent

有两种连接方式，任选其一：

使用 OAuth 登录：将服务 URL 添加到支持 OAuth 的 MCP 客户端。出现提示时，登录你的 518 账户或创建账户，然后批准所请求的权限。客户端会管理你的 OAuth 令牌。

claude mcp add --transport http 518-plus https://518.plus/mcp

使用 API 密钥：登录现有账户，并在 518.plus/account/keys 创建或查看密钥。需要创建新账户的 Agent 可以通过 HTTPS 注册：

curl -s -X POST https://518.plus/auth/mcp/register -H "Content-Type: application/json" -d '{}'
# → {"ok":true,"username":"agent_…","password":"…","key":{"key":"fsk_…",…}}
# save the username and password; use key.key as the Bearer credential

然后在每个请求中发送 Authorization: Bearer fsk_YOUR_API_KEY：

{
  "mcpServers": {
    "518-plus": {
      "type": "http",
      "url": "https://518.plus/mcp",
      "headers": { "Authorization": "Bearer fsk_YOUR_API_KEY" }
    }
  }
}

同一个密钥也适用于 REST 接口：

curl -s -X POST https://518.plus/v1/tools/compress \
  -H "Authorization: Bearer fsk_YOUR_API_KEY" \
  -H "Idempotency-Key: compress-request-1" \
  -F "[email protected]"

GET /v1/tools 会列出工具目录；Idempotency-Key 可确保重试安全； 接收请求体作为输入的工具会将请求体本身作为输入（Content-Type 按照 声明设置）。

如果要打包插件或连接器，请使用 CIMD（HTTPS 客户端元数据文档）或 DCR（POST /oauth/register）标识你的 OAuth 客户端；从 518.plus/.well-known/oauth-authorization-server 开始发现。客户端注册会记录应用程序信息，但不会创建 518 账户，也不会授予账户访问权限。账户所有者需单独批准所请求的作用域：tools:call、files:read、files:delete。

MCP 文件输入可以是内嵌的 base64、HTTPS URL 或引用；大文件需分两步上传。执行和上传凭证需要稳定的 client_ref：重试同一操作时请重复使用它。发现和文件管理工具使用其声明的参数。完整的 Agent 指南见 518.plus/llms.txt。

Agent Plugin 下载也在首页提供，其中包含可移植的 518-plus 插件目录，内有 plugin.json 和 mcp.json。解压后，按照客户端的 Agent Plugins 安装说明操作。它连接到同一个 /mcp 端点；请使用上述 OAuth 或 API 密钥访问流程。此软件包不包含账户凭据。

发布工具

已发布的工具是一个遵循工具契约的 HTTPS 端点。对于文件输入工具，518 会发送文件元数据、获取 URL 和参数：

{
  "files": [{ "filename": "a.png", "content_type": "image/png", "size": 1024, "url": "https://..." }],
  "params": { "quality": 80 }
}

若要返回有序的文本、JSON 或文件结果列表，请使用 Content-Type: application/vnd.518.items+json 响应：

{
  "items": [
    { "kind": "text", "text": "Compressed 1 image" },
    { "kind": "file", "filename": "a.png", "content_type": "image/png", "data_b64": "..." }
  ]
}

以积分设置价格（1,000 积分 = 1 美元）。调用失败时，系统会自动向用户退款。每次付费调用的收入份额将存入你的收益余额，你可以提取余额。完整的声明和执行契约见 docs/publishing.md。

新工具发布时默认为未公开（不会出现在公开市场中）。你成功运行自己的工具一次后，即可在「我的工具」中将其设为公开；平台不会审核工具。取消发布不受限制。

自托管

要求：Python 3.12、PostgreSQL 16、Gokapi v2.2.4、Nginx。

git clone https://github.com/samelabs/FlashShare.git && cd FlashShare
python3.12 -m venv venv && venv/bin/pip install -r requirements.txt
# set the environment variables listed in DEVELOPMENT.md, then:
venv/bin/python -m uvicorn app.main:app --host 127.0.0.1 --port 8000 --workers 1

数据库架构将在首次启动时创建。配置、部署和测试详见 DEVELOPMENT.md。

贡献

请阅读 AGENTS.md 了解架构契约，并阅读 DEVELOPMENT.md 了解本地测试栈。拉取请求必须通过 CI。

安全

请私下报告漏洞，详见 SECURITY.md。

许可证

AGPL-3.0