Apiany Mcp

APIAny MCP

APIAny 官方 MCP 服务，提供模型发现、定价信息、文档查询和 OpenAI 兼容的集成示例。

APIAny 为 Agent 和开发者提供 100 多种 AI 模型，用于聊天、图像、视频和多模态工作流。

快速开始 · 可视化设置 · MCP 工具 · Agent 技能 · 开发

English | 中文

本仓库提供的功能

APIAny MCP 为 AI Agent 提供结构化的方式来了解和使用 APIAny：

• 按提供商、模态、功能和定价元数据发现公开的 APIAny 模型。
• 在选择模型或运行工作流之前，估算 APIAny 积分用量。
• 从 APIAny 文档和 llms.txt 获取精简的文档上下文。
• 生成兼容 OpenAI 的 cURL、Python、JavaScript、Go、Java 和 PHP 示例。
• 仅在配置 API 密钥且用户明确确认付费使用时，才创建图像或视频生成任务。
• 将 Agent 技能打包到 skills/apiany-integration，让受支持的 Agent 了解 APIAny 工作流。

快速开始

使用 npm 直接运行服务：

npx -y @apiany-ai/mcp

或者从本仓库安装并运行：

git clone [email protected]:ailingqu/ApiAny.AI-MCP.git
cd ApiAny.AI-MCP
npm install
npm start

可视化设置

1. 安装并启动 MCP 服务

2. 将 APIAny MCP 添加到 Agent 客户端

在 Claude Code、Cursor、VS Code 或其他兼容 MCP 的客户端中使用此配置：

{
  "mcpServers": {
    "apiany": {
      "command": "npx",
      "args": ["-y", "@apiany-ai/mcp"],
      "env": {
        "APIANY_BASE_URL": "https://apiany.ai"
      }
    }
  }
}

对于付费图像或视频任务工具，还需设置 APIANY_API_KEY：

{
  "APIANY_BASE_URL": "https://apiany.ai",
  "APIANY_API_KEY": "your_apiany_api_key"
}

3. 让 Agent 使用 APIAny

提示词示例：

Use APIAny MCP to find an image model for product photos, compare pricing, and show JavaScript integration code.

Use APIAny MCP to estimate credits for 20 gpt-style chat requests with 10k input tokens and 5k output tokens.

Use APIAny MCP to show JavaScript usage for nano-banana-pro and Python usage for veo3-1-fast.

MCP 工具

工具	用途	API 密钥
list_models	列出公开的 APIAny 模型及其定价和能力元数据。	否
search_models	按文本、提供商、模态或能力搜索模型。	否
get_model	按模型 ID 或显示名称获取一个公开模型。	否
estimate_cost	根据公开定价元数据估算点数。	否
get_model_usage	返回模型的端点、有效负载、异步行为和语言示例。	否
get_integration_examples	返回 cURL、Python、JavaScript、Go、Java 或 PHP 示例。	否
get_docs_context	从 /llms.txt 返回精简的 APIAny 文档上下文。	否
create_image_task	在明确确认后创建付费异步图像任务。	是
create_video_task	在明确确认后创建付费异步视频任务。	是
get_task_status	读取异步媒体任务状态。	是

Agent 技能

APIAny 集成技能位于 skills/apiany-integration。

它可帮助 Agent：

• 根据模态、提供商、定价和能力选择 APIAny 模型。
• 为聊天、图像、视频和媒体工作流生成示例。
• 说明异步任务的创建和轮询。
• 在执行付费生成任务前要求明确确认。

环境变量

变量	必需	描述
APIANY_BASE_URL	否	APIAny 基础 URL。默认为 https://apiany.ai。
APIANY_API_KEY	仅付费工具需要	用于创建付费图像/视频任务和轮询任务的 API 密钥。

安全模型

只读工具无需 API 密钥即可使用。付费生成工具需要同时满足以下条件：

• APIANY_API_KEY
• confirm_paid_request=true

服务不会持久化 API 密钥，只会从当前进程环境中读取。

开发

npm install
npm run check
npx -y @modelcontextprotocol/inspector node src/server.js

实用文件：

• src/server.js：MCP 服务实现。
• examples/mcp.json：客户端配置示例。
• docs/distribution.md：npm、MCP 目录和技能市场的发布检查清单。
• CHANGELOG.md：发布历史。

链接

• 网站：https://apiany.ai
• GitHub：https://github.com/ailingqu/ApiAny.AI-MCP
• npm：https://www.npmjs.com/package/@apiany-ai/mcp
• 模型：https://apiany.ai/models
• 文档上下文：https://apiany.ai/llms.txt

许可证

MIT