AIStorageDepot

@aistoragedepot/mcp

一个 Model Context Protocol 服务，可将你的 AIStorageDepot 知识库提供给任何支持 MCP 的 AI 客户端使用 — Claude Desktop、Cursor、Cline、Windsurf 等。

你存储的内容会显示在你实际工作的地方：

• 提示词 → 你在应用中用 / 标记的项目会成为 MCP 提示词（斜杠命令）——支持任何类型，每个提示词中的 [field] 都会作为提示词参数显示，供你填写。
• 资源 → 每个项目（规则、文档、技能、MCP 配置、提示词）都可通过 aisd://item/<id> 读取，因此 Agent 可按需将“我的编码规则”或“我的项目指南” 加载到上下文中。
• 工具 → search_library(query) 和 get_item(id) 可让 Agent 以编程方式查找并获取 知识库中的任何内容。

无需账户即可试用（示例模式）

AISD_TOKEN 为可选项。不提供令牌运行服务，它就会提供一份免费的、只读的公开精选知识库， 让你在注册前先体验 AIStorageDepot 如何融入编辑器。之后添加令牌即可切换到你自己的和团队的知识库。添加服务时，使用空的 env（或省略 AISD_TOKEN）：

{
  "mcpServers": {
    "aisd": { "command": "npx", "args": ["-y", "@aistoragedepot/mcp"] }
  }
}

设置

👉 最简单的方式： 各应用的分步说明（包括配置文件位置等） 请访问 https://www.aistoragedepot.com/connect。手动设置方法如下：

1. 在 AIStorageDepot 中，前往 Settings → API tokens 并创建令牌（个人用户免费）。复制令牌。
2. 将服务添加到 MCP 客户端的配置中。示例（Claude Desktop / claude_desktop_config.json、Cursor ~/.cursor/mcp.json 等）：

{
  "mcpServers": {
    "aisd": {
      "command": "npx",
      "args": ["-y", "@aistoragedepot/mcp"],
      "env": {
        "AISD_TOKEN": "aisd_xxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

3. 重启客户端。你标记为 / 的项目会显示为斜杠命令；所有内容都可作为资源使用；search_library / get_item 工具也已就绪。

配置

环境变量	必需	默认值	说明
AISD_TOKEN	否	—	Settings → API tokens 中的令牌。不提供令牌 = 匿名示例模式（免费的公开精选知识库，只读）。提供令牌后，即可访问你自己的和团队的知识库。该令牌拥有账户的完整访问权限，请妥善保密。
AISD_BASE_URL	否	https://www.aistoragedepot.com	如有需要，可指向自托管 / 开发实例。
AISD_WORKSPACES	否	—	已停用。 斜杠菜单现在显示的是你在应用中标记为 / 的项目（严格按需选择）；此变量将被忽略。搜索和资源仍涵盖所有工作区。

斜杠命令（pull）

并非所有客户端都会将 MCP 提示词转换成 / 斜杠命令（有些客户端只使用工具）。若要将你的库同步为原生斜杠命令文件，请将其同步到你使用的每个 AI 工具，而不只是 Claude：

npx -y @aistoragedepot/mcp pull --token=aisd_your_token --to=all

目标	写入位置	命令显示为
claude （默认）	~/.claude/commands/aisd/	/aisd:<name>
cursor	~/.cursor/commands/	/aisd-<name>
vscode	你的 VS Code 配置文件中的 prompts/ 文件夹（Copilot Chat）	/aisd-<name>
windsurf	~/.codeium/windsurf/global_workflows/（Cascade）	/aisd-<name>
codex	~/.codex/prompts/	/prompts:aisd-<name>

未安装的工具会自动跳过。每种工具都会使用自己的方言（frontmatter、参数提示，以及受支持时使用的 $ARGUMENTS）。技能会原样运行。提示词需要输入：其中的 [fields] 会显示为参数提示，你在命令后输入的内容会填入这些字段——

/aisd:cold-outreach Jane at Globex, about our payments API

— 如果有值未填写，AI 会询问你。

选项	默认值
--to=…	claude	要为哪些工具写入命令——逗号分隔的列表，或 all。
--token=…	AISD_TOKEN 环境变量	你的 API 令牌。
--types=…	skill,prompt	要转换为命令的条目类型（例如，仅转换技能时使用 skill）。
--workspaces="A,B"	你的个人库	要拉取的工作区（名称，或 all）。
--project	关闭	改为写入当前仓库：.claude/commands/、.cursor/commands/、.github/prompts/、.windsurf/workflows/。
--dir=<path>	每个目标各自的默认位置	写入其他位置（仅限单个 --to）。

可以安全地重复运行：每个目标只会清除自己的文件（claude：其命名空间文件夹；其他工具：仅清除带有 aisd- 前缀的文件——不会触及你自己的命令）。

备注

• v0.1 中仅支持只读（可展示和获取你的内容；不会写回）。
• 库快照会缓存约 30 秒，因此短时间内多次调用只会访问 API 一次。
• 可随时前往 Settings → API tokens 撤销令牌；服务会立即失去访问权限。

本地开发

npm install
AISD_TOKEN=<token> AISD_BASE_URL=http://localhost:3100 npm run test:client