hikerapi-mcp

HikerAPI 的 MCP 服务器 — Instagram 数据 API。可在 npm 上获取：hikerapi-mcp。

在启动时根据 HikerAPI OpenAPI 规范自动生成 MCP 工具，因此无需手动编写包装器即可公开每个非弃用的 GET 端点。HikerAPI 仅公开读取 (GET) 端点 — 服务器将每个端点 1:1 映射到 MCP 工具（GET /v2/user/by/username → get_v2_user_by_username）。

获取 100 次免费 API 请求

使用此链接注册 即可获得 100 次免费 HikerAPI 请求 — 无需信用卡。足以连接 MCP 服务器，在 Claude/Cursor/Codex 中尝试几个提示词，并在提交前评估数据质量。

在此处获取您的 100 次免费请求

快速入门

1. 在 hikerapi.com/tokens 获取 API 密钥。

2. 将服务器添加到您的 AI 助手。

3. 向您的助手询问类似以下内容：

   • “获取 @nasa 的 Instagram 个人资料。”

   • “查找标签 #photography 下最近的 5 条热门帖子。”

   • “显示 id 为 25025320 的用户的快拍。”

Claude Code

claude mcp add hikerapi -e HIKERAPI_KEY=your-api-key -- npx -y hikerapi-mcp

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "hikerapi": {
      "command": "npx",
      "args": ["-y", "hikerapi-mcp"],
      "env": {
        "HIKERAPI_KEY": "your-api-key"
      }
    }
  }
}

Cursor / Windsurf

与 Claude Desktop 格式相同 — 将该块放在应用程序 MCP 配置文件中的 mcpServers 下。

Zed

添加到 ~/.config/zed/settings.json：

{
  "context_servers": {
    "hikerapi": {
      "command": "npx",
      "args": ["-y", "hikerapi-mcp"],
      "env": {
        "HIKERAPI_KEY": "your-api-key"
      }
    }
  }
}

OpenAI Codex

追加到 ~/.codex/config.toml：

[mcp_servers.hikerapi]
command = "npx"
args = ["-y", "hikerapi-mcp"]

[mcp_servers.hikerapi.env]
HIKERAPI_KEY = "your-api-key"

工具

工具在启动时根据实时 HikerAPI OpenAPI 规范 生成，因此列表始终与当前 API 匹配。在这些组中大约有 100 多个工具（截至撰写本文时的数量）：

每个工具名称都反映了其端点（GET /v2/user/by/username → get_v2_user_by_username）。您的助手可以通过 MCP 调用 tools/list 来获取包含参数模式的完整、最新的列表。默认情况下排除 Legacy 和 System 组。

配置

默认情况下排除 Legacy 和 System 标签。弃用的操作也会被跳过。

如果 HIKERAPI_URL 指向 api.hikerapi.com 或 api.instagrapi.com 以外的主机，服务器会在启动时打印警告 — 您的密钥将被发送到该处，因此仅将其用于自托管或代理的 HikerAPI。

示例 — 仅公开最常用的组：

"env": {
  "HIKERAPI_KEY": "...",
  "HIKERAPI_TAGS": "User Profile,Post Details,Search,Hashtags,Stories"
}

工作原理

AI Assistant ←stdio→ hikerapi-mcp ──https──> api.hikerapi.com
                          │
                          └─ fetches /openapi.json once on startup,
                             builds one MCP tool per GET endpoint

工具参数映射到端点的 query 和 path 参数。响应正文按原样返回（JSON 文本）。非 2xx 响应将作为带有 HTTP 状态和正文的工具错误显示。

开发

git clone https://github.com/subzeroid/hikerapi-mcp.git
cd hikerapi-mcp
npm install
npm run build
HIKERAPI_KEY=your-key node dist/index.js

以监视模式运行：

HIKERAPI_KEY=your-key npm run dev

运行测试（针对本地模拟服务器的单元测试 + stdio 冒烟测试，无需网络/API 密钥）：

npm test

许可证

MIT