InstaPods

Name: InstaPods
Author: instapods.com

远程服务

instapods.com云与基础设施05 周前更新

代码仓库访问官网

关于 InstaPods

InstaPods SDK 为 Claude 提供在 InstaPods 上部署和管理应用的集成方式，面向应用开发者。它结合 instapods 命令行技能与 MCP 工具，可用于部署和排查应用问题。

主要功能

01通过 instapods 命令行部署与调试
02使用 MCP 管理 InstaPods 应用
03提供部署与诊断提示词
04支持添加 PostgreSQL 数据库

适用场景

01将应用部署到 InstaPods
02排查应用返回 502 的问题
03为 pod 添加 PostgreSQL 数据库

MCP 相关

InstaPods MCP 服务通过 OAuth 向 Claude 提供应用管理工具和部署、诊断等提示词。也可通过 instapods 命令行技能进行集成。

配置

远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。

服务地址https://app.instapods.com/api/mcp

一键复制安装命令

Claude CodeTerminalclaude mcp add --transport http com-instapods-instapods https://app.instapods.com/api/mcp

Cursor.cursor/mcp.json{"mcpServers":{"com-instapods-instapods":{"type":"http","url":"https://app.instapods.com/api/mcp"}}}在 Cursor 中打开

VS Code.vscode/mcp.json{"servers":{"com-instapods-instapods":{"type":"http","url":"https://app.instapods.com/api/mcp"}}}在 VS Code 中打开

Claude Desktopclaude_desktop_config.json{"mcpServers":{"com-instapods-instapods":{"type":"http","url":"https://app.instapods.com/api/mcp"}}}

Windsurf~/.codeium/windsurf/mcp_config.json{"mcpServers":{"com-instapods-instapods":{"serverUrl":"https://app.instapods.com/api/mcp"}}}

命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。

工具

详细介绍

InstaPods SDK

用于通过 AI 助手在 InstaPods 上部署和管理应用的工具与集成。

InstaPods 为开发者提供应用托管服务——真正的 Linux 服务器，一条命令即可操作。几秒钟内即可部署 Node.js、Python、PHP 和静态应用。此 SDK 提供两种将 InstaPods 集成到 Claude 的方式：

集成方式

Claude Code（CLI 技能）

一项技能，用于教 Claude Code 如何使用 instapods CLI 部署和调试应用。

设置：

安装 CLI：

curl -fsSL https://instapods.com/install.sh | sh
instapods auth login

将技能复制到项目中：

mkdir -p .claude/skills/instapods-cli
curl -fsSL https://raw.githubusercontent.com/instapods/sdk/main/skills/instapods-cli/SKILL.md \
  -o .claude/skills/instapods-cli/SKILL.md

让 Claude Code 进行部署：

> deploy my app to instapods
> my app is returning 502, help me debug
> add a PostgreSQL database to my pod

Claude Desktop / Claude.ai（MCP 技能）

有两种方式——使用 MCP 技能来引导工作流，或直接通过 MCP 连接。

选项 A：MCP 技能（推荐）

将技能复制到项目中：

mkdir -p .claude/skills/instapods-mcp
curl -fsSL https://raw.githubusercontent.com/instapods/sdk/main/skills/instapods-mcp/SKILL.md \
  -o .claude/skills/instapods-mcp/SKILL.md

选项 B：直接连接 MCP

添加到 Claude Desktop 配置文件（~/Library/Application Support/Claude/claude_desktop_config.json）中：

{
  "mcpServers": {
    "instapods": {
      "url": "https://app.instapods.com/api/mcp"
    }
  }
}

首次使用时，Claude 会引导你完成 OAuth 身份验证。完整设置指南请参阅 mcp/README.md。

MCP 服务内置了提示词：

deploy-app — 引导式部署工作流
debug-pod — 系统化 Pod 诊断
getting-started — 可用工具和资源概览

此仓库包含的内容

sdk/
├── README.md                              # This file
├── server.json                            # MCP Registry manifest (see below)
├── skills/
│   ├── instapods-cli/
│   │   └── SKILL.md                       # Skill for Claude Code (uses CLI)
│   └── instapods-mcp/
│       └── SKILL.md                       # Skill for Claude Desktop/Claude.ai (uses MCP tools)
├── mcp/
│   └── README.md                          # MCP server setup guide
└── cli/
    └── README.md                          # CLI quick reference

MCP 注册表

InstaPods 已列入官方 MCP Registry，条目为 com.instapods/instapods。此仓库中的 server.json 是该条目的权威来源：

curl -s "https://registry.modelcontextprotocol.io/v0/servers?search=instapods"

要发布更新，请递增 server.json 中的 version，然后推送匹配的标签：

git tag mcp-v1.1.0 && git push origin mcp-v1.1.0

这会运行 .github/workflows/publish-mcp-registry.yml，通过 mcp-publisher 发布。注册表不接受已存在的版本，因此每次发布都需要使用新的 version。

身份验证基于域名：注册表命名空间 com.instapods/* 通过在 https://instapods.com/.well-known/mcp-registry-auth 提供的 Ed25519 公钥进行验证。工作流使用仓库机密 MCP_REGISTRY_PRIVATE_KEY 中匹配的私钥进行签名。GitHub OIDC 在此处不可用——它只能授予 io.github.* 命名空间。