MCP 服务器与 Skill

让 AI 助手直接查询 MyAltBox：找某个产品的替代品、对比开源和可自托管的方案、提交新产品，在 Claude、Cursor 等支持 MCP 的客户端里都可以完成。

MyAltBox 提供两种接入方式：

• MCP 服务器：远程服务器地址为 https://myaltbox.com/api/mcp，给 AI 助手提供结构化的工具。
• Skill：一份简短的说明文件，告诉 Claude 什么时候、怎样使用 MyAltBox。可以单独使用，和 MCP 服务器一起用效果更好。

工具

工具	作用	需要令牌
search_services	按关键词搜索，可按分类、开源、可自托管筛选	否
get_service	单个产品的详情：简介、许可证、定价、平台、主要功能和详细介绍	否
get_alternatives	社区推荐的替代品，按投票排序	否
list_categories	全部分类及每个分类的产品数量	否
submit_service	只需名称和官网即可提交新产品	是
add_alternative	把一个产品标记为另一个产品的替代品	是

每个工具都可以传入 locale（en、zh、ja、ko），简介、分类和页面链接会按该语言返回。

通过 MCP 提交的产品和提交页面规则相同：AI 读取官网后补全分类、简介和标签，管理员审核后发布。非管理员账号每天的提交数量有上限。

API 令牌

搜索类工具不需要账号。要提交产品或添加替代品，请在下方创建个人 API 令牌，并以 Authorization: Bearer <令牌> 的形式发送。

• 令牌只显示一次，请像密码一样保管。
• 可以随时在这里撤销令牌，使用它的客户端会立即失去写入权限。

连接客户端

Claude Code

# 只使用搜索类工具
claude mcp add --transport http myaltbox https://myaltbox.com/api/mcp

# 带上令牌，在所有项目中可用
claude mcp add --transport http myaltbox https://myaltbox.com/api/mcp \
  --scope user --header "Authorization: Bearer mab_你的令牌"

在 Claude Code 中运行 /mcp 可以查看连接状态。

想在项目里共享这个服务器、又不想把令牌提交进仓库，可以写进 .mcp.json，令牌从环境变量读取：

{
  "mcpServers": {
    "myaltbox": {
      "type": "http",
      "url": "https://myaltbox.com/api/mcp",
      "headers": { "Authorization": "Bearer ${MYALTBOX_TOKEN}" }
    }
  }
}

Claude Desktop 与 claude.ai

在「设置 → Connectors（连接器）」中添加自定义连接器，地址填 https://myaltbox.com/api/mcp。自定义连接器目前不能附带令牌请求头，所以只能使用搜索类工具。

Cursor

写入 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "myaltbox": {
      "url": "https://myaltbox.com/api/mcp",
      "headers": { "Authorization": "Bearer mab_你的令牌" }
    }
  }
}

VS Code

写入 .vscode/mcp.json：

{
  "servers": {
    "myaltbox": {
      "type": "http",
      "url": "https://myaltbox.com/api/mcp",
      "headers": { "Authorization": "Bearer mab_你的令牌" }
    }
  }
}

其他客户端

支持 Streamable HTTP 传输方式的客户端都可以使用，地址填 https://myaltbox.com/api/mcp。只需要搜索类工具时，去掉 headers 部分即可。

Skill

Skill 告诉 Claude 什么场景适合用 MyAltBox（比如「什么可以替代 Notion？」「可以自托管的密码管理器」），以及怎样展示结果。已连接 MCP 服务器时调用 MCP 工具，没有连接时使用公开的搜索接口。

Claude Code

mkdir -p ~/.claude/skills/myaltbox
curl -fsSL https://myaltbox.com/skills/myaltbox/SKILL.md -o ~/.claude/skills/myaltbox/SKILL.md

问题相关时 Claude 会自动加载，也可以直接输入 /myaltbox。

Claude Desktop 与 claude.ai

下载 myaltbox.zip，在「设置 → Capabilities（功能）→ Skills」中上传。

安装前可以先查看 Skill 内容。

示例提示词

• 「有哪些可以自托管的 Notion 开源替代品？」
• 「用 MyAltBox 对比一下 Jellyfin 和 Plex。」
• 「找一个支持 Linux 和 Android 的免费密码管理器。」
• 「把 Zed（https://zed.dev）作为 Visual Studio Code 的替代品添加到 MyAltBox。」