{"_id":"@apiany-ai/mcp","_rev":"3-4e39adb5cf9ce017bbdceb757825ad84","name":"@apiany-ai/mcp","dist-tags":{"latest":"0.1.2"},"versions":{"0.1.0":{"name":"@apiany-ai/mcp","version":"0.1.0","keywords":["apiany","mcp","model-context-protocol","ai","api","llm","image-generation","video-generation"],"license":"MIT","_id":"@apiany-ai/mcp@0.1.0","maintainers":[{"name":"apiany-ai","email":"loke.2024.ionet@gmail.com"}],"homepage":"https://apiany.ai","bugs":{"url":"https://github.com/ailingqu/ApiAny.AI-MCP/issues"},"bin":{"apiany-mcp":"src/server.js"},"dist":{"shasum":"18cc796a015c66c11c58fdc088693dda5214f186","tarball":"https://registry.npmjs.org/@apiany-ai/mcp/-/mcp-0.1.0.tgz","fileCount":5,"integrity":"sha512-Cvm6aV5ompBPXBYfsPU+g1O/tKb3s2qlPGz/P1JazTMzBpgea4RIMvI/rPmweDLls00zBwHFirqcxLXg3x3zTw==","signatures":[{"sig":"MEYCIQCXsXaRD46tV9ZZQbydCMl9+f5Y+mWg0Rmi85ZkG47KoAIhAKwofUyATrOnhIRKDFfL84SpjpEGBMDK0eLNR//OLlhA","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":27175},"type":"module","engines":{"node":">=20"},"gitHead":"78448f83c6fe46f27f27edabfecc3dd2e38feafe","scripts":{"check":"node --check src/server.js","start":"node src/server.js"},"_npmUser":{"name":"apiany-ai","email":"loke.2024.ionet@gmail.com"},"repository":{"url":"git+ssh://git@github.com/ailingqu/ApiAny.AI-MCP.git","type":"git"},"_npmVersion":"11.12.1","description":"MCP server for discovering APIAny models, pricing, docs, and integration examples.","directories":{},"_nodeVersion":"25.9.0","dependencies":{"zod":"^4.3.6","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.0_1782263701770_0.08054328126101096","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@apiany-ai/mcp","version":"0.1.1","keywords":["apiany","mcp","model-context-protocol","ai","api","llm","image-generation","video-generation"],"license":"MIT","_id":"@apiany-ai/mcp@0.1.1","maintainers":[{"name":"apiany-ai","email":"loke.2024.ionet@gmail.com"}],"homepage":"https://apiany.ai","bugs":{"url":"https://github.com/ailingqu/ApiAny.AI-MCP/issues"},"bin":{"apiany-mcp":"src/server.js"},"dist":{"shasum":"c003ee54d507fccadb25d164e8420db03069fce9","tarball":"https://registry.npmjs.org/@apiany-ai/mcp/-/mcp-0.1.1.tgz","fileCount":21,"integrity":"sha512-UgFXTI8wu93W9A8HzUjY8Kn3iAAbmx3s5UPxKcoq0vqBoBQKAYXhrrb9e7Q5t+eTorFteD3DnRfhJWaJV0nl8g==","signatures":[{"sig":"MEQCIFG5hFbdCBXVqC5EwiErQ5RXs5h92zobITulswIPhgqFAiAdBeFW+N/ikPwV9LVTnQ/tIGWZx3Em7f3zwXORnXJxPQ==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":169109},"type":"module","engines":{"node":">=20"},"gitHead":"17253c454c17abc7af682f21a5f99d4650109783","mcpName":"io.github.ailingqu/apiany-mcp","scripts":{"check":"node --check src/server.js","start":"node src/server.js"},"_npmUser":{"name":"apiany-ai","email":"loke.2024.ionet@gmail.com"},"repository":{"url":"git+ssh://git@github.com/ailingqu/ApiAny.AI-MCP.git","type":"git"},"_npmVersion":"11.12.1","description":"MCP server for discovering APIAny models, pricing, docs, and integration examples.","directories":{},"_nodeVersion":"25.9.0","dependencies":{"zod":"^4.3.6","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.1_1782266140009_0.7875073145095135","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"@apiany-ai/mcp","version":"0.1.2","mcpName":"io.github.ailingqu/apiany-mcp","description":"MCP server for discovering APIAny models, pricing, docs, and integration examples.","type":"module","homepage":"https://apiany.ai","repository":{"type":"git","url":"git+ssh://git@github.com/ailingqu/ApiAny.AI-MCP.git"},"bugs":{"url":"https://github.com/ailingqu/ApiAny.AI-MCP/issues"},"bin":{"apiany-mcp":"src/server.js"},"keywords":["apiany","mcp","model-context-protocol","ai","api","llm","image-generation","video-generation"],"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"^1.29.0","zod":"^4.3.6"},"engines":{"node":">=20"},"scripts":{"start":"node src/server.js","check":"node --check src/server.js"},"gitHead":"45ef4ad6e8ce946de926a294d29216fea062427f","_id":"@apiany-ai/mcp@0.1.2","_nodeVersion":"25.9.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-5glOPFRydMG4imv2lx/5778LZQPG+t0vt//smmD+cieQjTULMvOl8AvSHZvjtFhDNcDA5rWdQfiWHdg6kGEb8w==","shasum":"8148dd0d1fbd58a6f1e1d8cc0a669d40294d412e","tarball":"https://registry.npmjs.org/@apiany-ai/mcp/-/mcp-0.1.2.tgz","fileCount":22,"unpackedSize":169797,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIB6PdoQWPOgvbXWuJljow99pIpWFjN7l9hFVUgpFVuxtAiEA1UAkN5LB7YzD/R5i/fWJUBK1SY9bNh7FPIXJb/HMYBc="}]},"_npmUser":{"name":"apiany-ai","email":"loke.2024.ionet@gmail.com"},"directories":{},"maintainers":[{"name":"apiany-ai","email":"loke.2024.ionet@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.1.2_1782266347570_0.745573504009327"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-24T01:15:01.582Z","modified":"2026-06-24T01:59:07.850Z","0.1.0":"2026-06-24T01:15:01.936Z","0.1.1":"2026-06-24T01:55:40.150Z","0.1.2":"2026-06-24T01:59:07.751Z"},"bugs":{"url":"https://github.com/ailingqu/ApiAny.AI-MCP/issues"},"license":"MIT","homepage":"https://apiany.ai","keywords":["apiany","mcp","model-context-protocol","ai","api","llm","image-generation","video-generation"],"repository":{"type":"git","url":"git+ssh://git@github.com/ailingqu/ApiAny.AI-MCP.git"},"description":"MCP server for discovering APIAny models, pricing, docs, and integration examples.","maintainers":[{"name":"apiany-ai","email":"loke.2024.ionet@gmail.com"}],"readme":"<h1 align=\"center\">APIAny MCP</h1>\n\n<p align=\"center\">\n  <strong>APIAny 官方 MCP 服务：为智能体提供模型发现、价格上下文、文档检索和 OpenAI 兼容调用示例。</strong>\n</p>\n\n<p align=\"center\">\n  <a href=\"https://apiany.ai\">APIAny</a> 为开发者和智能体统一接入 100+ 个聊天、图像、视频和多模态 AI 模型。\n</p>\n\n<p align=\"center\">\n  <a href=\"https://www.npmjs.com/package/@apiany-ai/mcp\"><img alt=\"npm version\" src=\"https://img.shields.io/npm/v/@apiany-ai/mcp?style=flat-square&color=174CFF\"></a>\n  <a href=\"https://www.npmjs.com/package/@apiany-ai/mcp\"><img alt=\"npm package\" src=\"https://img.shields.io/badge/npm-%40apiany--ai%2Fmcp-CB3837?style=flat-square\"></a>\n  <a href=\"https://github.com/ailingqu/ApiAny.AI-MCP/releases\"><img alt=\"release\" src=\"https://img.shields.io/github/v/release/ailingqu/ApiAny.AI-MCP?style=flat-square&color=12B76A\"></a>\n  <a href=\"LICENSE\"><img alt=\"license\" src=\"https://img.shields.io/badge/license-MIT-344054?style=flat-square\"></a>\n  <img alt=\"Node.js\" src=\"https://img.shields.io/badge/node-%3E%3D20-339933?style=flat-square\">\n  <img alt=\"MCP server\" src=\"https://img.shields.io/badge/type-MCP%20Server-7C3AED?style=flat-square\">\n</p>\n\n<p align=\"center\">\n  <a href=\"#快速开始\">快速开始</a> ·\n  <a href=\"#图文配置\">图文配置</a> ·\n  <a href=\"#mcp-工具\">MCP 工具</a> ·\n  <a href=\"#agent-skill\">Agent Skill</a> ·\n  <a href=\"#开发\">开发</a>\n</p>\n\n<p align=\"center\">\n  <a href=\"README.md\">English</a> | <strong>中文</strong>\n</p>\n\n<p align=\"center\">\n  <img src=\"assets/readme/overview.svg\" alt=\"APIAny MCP 概览\" width=\"920\">\n</p>\n\n## 这个仓库提供什么\n\nAPIAny MCP 让 AI Agent 可以用结构化工具理解并使用 [APIAny](https://apiany.ai)：\n\n- 按供应商、模型类型、能力和价格元数据发现 APIAny 公共模型。\n- 在选择模型或执行工作流前估算 APIAny credits。\n- 从 APIAny 文档和 `llms.txt` 获取紧凑文档上下文。\n- 生成 OpenAI 兼容的 cURL、Python、JavaScript、Go、Java、PHP 调用示例。\n- 仅在配置 API key 且用户明确确认付费请求时，创建图像或视频生成任务。\n- 在 `skills/apiany-integration` 中提供 Agent Skill，让支持 skill 的智能体理解 APIAny 工作流。\n\n## 快速开始\n\n直接通过 npm 运行：\n\n```bash\nnpx -y @apiany-ai/mcp\n```\n\n或者从源码运行：\n\n```bash\ngit clone git@github.com:ailingqu/ApiAny.AI-MCP.git\ncd ApiAny.AI-MCP\nnpm install\nnpm start\n```\n\n## 图文配置\n\n### 1. 安装并启动 MCP 服务\n\n<p align=\"center\">\n  <img src=\"assets/readme/install.svg\" alt=\"通过 npx 安装 APIAny MCP\" width=\"900\">\n</p>\n\n### 2. 在 Agent 客户端中加入 APIAny MCP\n\n可用于 Claude Code、Cursor、VS Code 或其他兼容 MCP 的客户端：\n\n<p align=\"center\">\n  <img src=\"assets/readme/config.svg\" alt=\"APIAny MCP 客户端配置\" width=\"900\">\n</p>\n\n```json\n{\n  \"mcpServers\": {\n    \"apiany\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@apiany-ai/mcp\"],\n      \"env\": {\n        \"APIANY_BASE_URL\": \"https://apiany.ai\"\n      }\n    }\n  }\n}\n```\n\n如果要使用付费图像或视频任务工具，还需要配置 `APIANY_API_KEY`：\n\n```json\n{\n  \"APIANY_BASE_URL\": \"https://apiany.ai\",\n  \"APIANY_API_KEY\": \"your_apiany_api_key\"\n}\n```\n\n### 3. 让 Agent 使用 APIAny\n\n<p align=\"center\">\n  <img src=\"assets/readme/tools.svg\" alt=\"Agent 对话中调用 APIAny MCP 工具\" width=\"900\">\n</p>\n\n示例提示词：\n\n```text\n使用 APIAny MCP 找一个适合商品图的图像模型，对比价格，并给我 JavaScript 调用示例。\n```\n\n```text\n使用 APIAny MCP 估算 20 次聊天请求的 credits，输入 10k tokens，输出 5k tokens。\n```\n\n```text\n使用 APIAny MCP 展示 nano-banana-pro 的 JavaScript 用法，以及 veo3-1-fast 的 Python 用法。\n```\n\n## MCP 工具\n\n| 工具 | 用途 | 是否需要 API key |\n| --- | --- | --- |\n| `list_models` | 列出公共 APIAny 模型、价格和能力元数据。 | 否 |\n| `search_models` | 按文本、供应商、类型或能力搜索模型。 | 否 |\n| `get_model` | 按模型 ID 或显示名称获取单个模型。 | 否 |\n| `estimate_cost` | 根据公共价格元数据估算 credits。 | 否 |\n| `get_model_usage` | 返回模型 endpoint、payload、异步行为和语言示例。 | 否 |\n| `get_integration_examples` | 返回 cURL、Python、JavaScript、Go、Java、PHP 示例。 | 否 |\n| `get_docs_context` | 从 `/llms.txt` 返回紧凑 APIAny 文档上下文。 | 否 |\n| `create_image_task` | 在明确确认后创建付费异步图像任务。 | 是 |\n| `create_video_task` | 在明确确认后创建付费异步视频任务。 | 是 |\n| `get_task_status` | 查询异步媒体任务状态。 | 是 |\n\n## Agent Skill\n\nAPIAny Integration skill 位于 [`skills/apiany-integration`](skills/apiany-integration)。\n\n它可以帮助智能体：\n\n- 按类型、供应商、价格和能力选择 APIAny 模型。\n- 生成聊天、图像、视频和媒体工作流示例。\n- 解释异步任务创建和轮询流程。\n- 在付费生成任务前要求用户明确确认。\n\n## 环境变量\n\n| 变量 | 是否必需 | 说明 |\n| --- | --- | --- |\n| `APIANY_BASE_URL` | 否 | APIAny 基础 URL，默认 `https://apiany.ai`。 |\n| `APIANY_API_KEY` | 仅付费工具需要 | 用于创建付费图像/视频任务和查询任务状态。 |\n\n## 安全边界\n\n只读工具不需要 API key。付费生成工具必须同时满足：\n\n- 配置 `APIANY_API_KEY`\n- 请求参数包含 `confirm_paid_request=true`\n\n服务不会持久化 API key，只会从当前进程环境变量读取。\n\n## 开发\n\n```bash\nnpm install\nnpm run check\nnpx -y @modelcontextprotocol/inspector node src/server.js\n```\n\n常用文件：\n\n- [`src/server.js`](src/server.js)：MCP 服务实现。\n- [`examples/mcp.json`](examples/mcp.json)：客户端配置示例。\n- [`docs/distribution.md`](docs/distribution.md)：npm、MCP 目录和 skill 市场发布清单。\n- [`CHANGELOG.md`](CHANGELOG.md)：发布记录。\n\n## 链接\n\n- 官网：[https://apiany.ai](https://apiany.ai)\n- GitHub：[https://github.com/ailingqu/ApiAny.AI-MCP](https://github.com/ailingqu/ApiAny.AI-MCP)\n- npm：[https://www.npmjs.com/package/@apiany-ai/mcp](https://www.npmjs.com/package/@apiany-ai/mcp)\n- Models：[https://apiany.ai/models](https://apiany.ai/models)\n- Docs context：[https://apiany.ai/llms.txt](https://apiany.ai/llms.txt)\n\n## License\n\nMIT\n","readmeFilename":"README.zh-CN.md"}