MCPShortURL

MCPShortURL 是一个基于模型上下文协议（MCP）的服务器，用于通过 Ace Data Cloud 的 Short URL API 创建和管理短链接。它让你可以在 Claude、VS Code 或任何兼容 MCP 的客户端中直接创建简短、可分享的网址。

用途 该项目的主要用途是网址缩短：将冗长的 URL 转换为短小、可分享的链接，既支持单条转换，也支持批量处理。短链接使用简洁的 surl.id 域名，并且永久有效、不会过期。

主要能力

• URL 缩短：将长网址转换为简短可分享的链接。
• 批量缩短：一次缩短多个网址，每批最多 10 个。
• 免费服务：每次请求消耗 0 信用点。
• 永久链接：短链接永不过期。
• surl.id 域名：短链接使用简洁的 surl.id 域名。
• Bearer 认证：通过令牌认证实现安全的 API 访问。

使用方式（连接方式） 该 MCP 服务器提供三种接入路线：托管 OAuth、API 令牌或本地 stdio。托管端点为 https://shorturl.mcp.acedata.cloud/mcp，为 MCP 客户端选择其中一种路线即可。

托管 OAuth 方面：托管服务公布 OAuth 元数据与动态客户端注册（DCR）。DCR 注册的是客户端应用，并非 API 密钥。OAuth 用于登录，客户端会发送生成的 Bearer 令牌，它可能复用或为账户创建 API 凭据。浏览器登录仍需 AceDataCloud 账户。托管服务可能计费：在真实操作前请查阅当前服务文档与显示的定价。不要为同一个服务器同时配置 OAuth 登录和固定 Authorization 头。

各客户端的托管 OAuth 配置示例：

• Claude 和 Claude Desktop 聊天：在 Customize → Connectors → Add custom connector 中添加远程自定义连接器，输入 https://shorturl.mcp.acedata.cloud/mcp，选择登录，如果 Claude 询问如何注册其 OAuth 客户端，选择 Register automatically，然后完成授权。Claude Desktop 本地的 claude_desktop_config.json 是另一套独立配置。
• Claude Code：执行 claude mcp add --transport http --scope user shorturl https://shorturl.mcp.acedata.cloud/mcp，然后执行 claude mcp login shorturl，用 /mcp 检查。
• Cursor：添加仅含 https://shorturl.mcp.acedata.cloud/mcp 的远程服务器。项目使用则将该条目合并到 <project>/.cursor/mcp.json；个人使用则用 ~/.cursor/mcp.json。
• VS Code / Copilot：运行 MCP: Add Server，选择 HTTP，输入 https://shorturl.mcp.acedata.cloud/mcp，然后完成浏览器登录。新的可移植工作区配置使用 <project>/.mcp.json；VS Code 专用格式使用 <project>/.vscode/mcp.json 或用户配置文件。用 MCP: List Servers 检查。
• Codex：执行 codex mcp add shorturl --url https://shorturl.mcp.acedata.cloud/mcp，然后执行 codex mcp login shorturl。其用户设置在 ~/.codex/config.toml。

托管 API 令牌方面：打开 Ace Data Cloud → Applications，登录或先注册账户。找到 General 应用；如果尚未创建，选择 Initialize General Application。通用密钥可使用账户可用的服务；专用应用的密钥仅限于其服务。检查所需服务/模型访问权限和当前定价。从应用卡片复制 API Key，或打开 Keys / Manage Keys → Create 为本集成创建单独的密钥。给它一个可识别的名称，以便独立撤销或轮换。创建密钥时，查看 Expiration Time、Set Usage Limitation 和 Allowed APIs，只启用需要的限制，允许将要调用的操作，然后点击 Create 并从密钥列表复制令牌。任务查询并不授予提交生成的权限。确认应用余额足以支付首次请求；任何试用额度以账户当前显示为准。只复制令牌值，不带引号、空格或 Bearer 前缀。API Key / API Token 字段期望这个原始值；只有手动配置的 HTTP Authorization 头才需要 Bearer 前缀。platform-... 账户管理令牌不能替代生成 API 密钥。将密钥保存在客户端凭据存储或下面所示的环境变量中。绝不要把它放在提示词、共享工作流、截图或 Git 提交中。如果认证失败，在创建新密钥之前，请检查完整复制的值、应用/服务访问权限、过期时间、使用限制和余额。固定的 Bearer 头会绕过 OAuth；如果该头无效，在尝试浏览器登录前先移除它；请妥善保管保存的凭据。

本地安装方面：安装该包并为本地进程提供 API 令牌。对于 Claude Desktop 本地 MCP，将此条目合并到其开发者设置打开的文件中（macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json）。uvx 要求 uv 在 PATH 中。请对该用户级文件保密。自托管 HTTP 使用 mcp-shorturl --transport http --port 8000；仅在合适的网络与 TLS 控制下对外暴露。本地执行仍会调用 AceDataCloud API。

其他客户端：Cline 使用其 MCP 配置 UI 或 CLI 文件 ~/.cline/data/settings/cline_mcp_settings.json，其远程传输值为 streamableHttp。JetBrains AI Assistant 在 Settings → Tools → AI Assistant → Model Context Protocol (MCP) 中添加远程 URL。Zed 使用 context_servers 条目，OAuth 时仅填 URL，或添加本地 Bearer 头。这些客户端的配置模式不同，请遵循其当前 UI，而不是复制其他客户端的 JSON。

使用前检查

• 访问 https://shorturl.mcp.acedata.cloud/health 返回 {"status":"ok"} 仅检查端点可达性。
• 确认 MCP 客户端加载了工具。shorturl_get_usage_guide 是参考工具，它不验证下游 API 访问或余额。
• 如果需要完整的 API 检查，在查阅当前服务文档和显示的定价后，用你自己的有效输入调用 shorturl_create。
• 遇到 401 时，检查客户端使用了哪条认证路线，以及令牌或 OAuth 会话是否有效。403 可能意味着账户权限或内容审核失败，请阅读返回的错误。余额不足和下游服务失败需要分别诊断。列出的工具或提交的任务并不证明结果成功。

可用工具

• URL 缩短工具
• 信息工具

使用示例

• 缩短单个网址
• 批量缩短多个网址
• 为文档创建链接

技术细节 该服务器封装了 AceDataCloud Short URL API：

• 端点：POST /shorturl
• 输入：{ "content": "https://long-url.example.com/..." }
• 输出：{ "success": true, "data": { "url": "https://surl.id/..." } }
• 定价：免费（0 信用点）
• 认证：Bearer 令牌

完整 API 文档见 AceDataCloud Platform。项目采用 MIT 许可证，详见 LICENSE 文件。

适用场景 适用于需要在文档、分享内容或日常工作流中快速生成可分享短链接的场景，尤其是已经使用 MCP 兼容客户端并希望在对话或编辑器中直接缩短网址的用户。批量功能适合一次处理多个链接的需求。

限制

• 批量缩短每批最多 10 个。
• 托管服务可能计费，实际定价以服务文档与界面显示为准。
• 需要 AceDataCloud 账户及有效的 API 令牌或 OAuth 登录。
• 本地执行仍会调用 AceDataCloud API，并非完全离线。
• 具体的可用工具名称、环境变量、命令行选项、开发与发布流程等细节，资料中未完整列出，暂未提供。