ALAPI
公式ALAPI MCP Tools,Call hundreds of API interfaces via MCP
🔥 ALAPI MCP Server
这是一个基于 ALAPI 的 MCP (Model Context Protocol) 服务器实现,可以通过MCP协议直接调用ALAPI的接口,轻松将ALAPI丰富的API资源集成到各类支持MCP的AI应用中。
✨ 功能特点
- 🔍 丰富API资源 - 提供IP查询、天气查询、热搜榜单、企业信息等100+种常用API服务
- 🧩 MCP 协议支持 - 完全兼容 Model Context Protocol,轻松集成到各类AI应用
- 🔄 自动加载 - 自动加载 ALAPI OpenAPI 规范,无需手动配置
- 🎯 灵活调用 - 支持加载全部或指定API,按需使用(短视频解析、天气查询、每天60秒读懂世界、企业查询等)
- 🛡️ 统一响应 - 提供统一的错误处理和响应格式,简化开发流程
- ⚙️ 可配置性 - 支持环境变量配置,轻松适应不同使用场景
📖 使用指南
首先需要了解 MCP 协议,然后按照以下配置添加 ALAPI MCP 服务。
在 MCP 客户端中使用
ALAPI MCP Server 设计为与支持 MCP 协议的客户端配合使用,不支持独立的命令行配置。请按照以下步骤在您的 MCP 客户端中配置使用:
方法一: 远程 MCP
本项目支持一键部署到腾讯云开发平台,提供远程 SSE 访问
方法二:使用 Smithery 自动安装
通过 Smithery 安装 ALAPI MCP Server,适用于 Claude Desktop 客户端:
npx -y @smithery/cli install @ALAPI-SDK/mcp-alapi-cn --client claude
方法三:直接使用预编译二进制文件(推荐,不用安装依赖)
-
访问 Releases 页面 下载最新版本
-
根据您的操作系统选择对应最新的版本:
- Windows:
mcp-alapi-cn.exe - macOS:
mcp-alapi-cn-macos - Linux:
mcp-alapi-cn-linux
- Windows:
-
在支持 MCP 的客户端(如 Claude Desktop)中配置:
- 打开 MCP 客户端设置
- 添加新的 MCP 服务器
- 指定下载的二进制文件路径
- 配置必要的环境变量(如
ALAPI_TOKEN)
配置环境变量
ALAPI_TOKEN - ALAPI平台访问令牌(必填)
需要配置为您在 ALAPI 平台上创建的 TOKEN,用于接口认证。
MCP 客户端配置示例
在 Claude Desktop 或其他支持 MCP 的客户端中,可以参考以下配置:
JSON 配置(使用本地二进制文件)
{
"mcpServers": {
"alapi": {
"path": "/path/to/mcp-alapi-cn",
"env": {
"ALAPI_TOKEN": "在 ALAPI 平台申请创建的 token"
}
}
}
}
支持的 MCP 客户端
根据 MCP 文档,以下客户端支持 MCP 工具集成:
- Claude Desktop App
- Claude Code
- Cursor
- Continue
- Cline
- 等其他支持 MCP 协议的客户端
注意:确保您的 MCP 客户端支持工具集成功能,请参考各客户端的具体文档进行配置。
🛠️ 支持的功能
以下是部分支持的功能,完整功能请以实际调用为准:
| 功能名称 | 描述 |
|---|---|
| IP查询 | 查询IP归属地信息,支持IPv4和IPv6 |
| 天气查询 | 查询国内天气详情,包含天气信息、天气预警、天气指数、AQI等 |
| 今日热榜 | 查询今日热榜数据,包含抖音热搜、头条热榜、知乎、36k、百度热搜、微博热搜等数据 |
| 文本审核 | 查询文本是否违规,特别适合AI内容审核 |
| 短网址 | 短网址缩短,将长网址缩短为短网址,方便短信发送、二维码生成等场景 |
| 二维码识别 | 支持一图多码,支持数十二维码,条形码的识别 |
| 历史上的今天 | 查询历史上的指定日期发生的大事 |
| 汇率查询 | 根据货币代码查询货币汇率和换算,支持全球170+个国家和地区货币查询 |
| 企业查询 | 根据企业名称或统一社会信用代码查询企业基本工商信息 |
| 快递查询 | 免费查询快递物流轨迹,支持中通、申通、顺丰、极兔、百世、圆通等 |
| 星座运势 | 提供星座运势查询服务,支持查询十二星座今日或明日、本周、本月、本年的运势 |
| 黄金价格 | 查询当前黄金的实时价格,最高价,最低价,品牌黄金的价格 |
🔗 相关链接
🙏 鸣谢
- ALAPI - 提供强大的API支持
- Model Context Protocol - 提供协议标准
関連サーバー
Alpha Vantage MCP Server
スポンサーAccess financial market data: realtime & historical stock, ETF, options, forex, crypto, commodities, fundamentals, technical indicators, & more
Remote MCP Server (Authless)
A remote MCP server deployable on Cloudflare Workers without authentication.
Remote MCP Server (Authless)
An example of a remote MCP server without authentication, deployable on Cloudflare Workers.
Cloudflare MCP Server
An example MCP server designed for easy deployment on Cloudflare Workers, operating without authentication.
E2B
Run code in secure sandboxes hosted by E2B
Klever VM
MCP server for [Klever](https://klever.org) blockchain smart contract development, on-chain data exploration, and VM interaction. Public remote server available at `https://mcp.klever.org/mcp`.
Chrome Debug MCP Server
Control Chrome with debugging capabilities, userscript injection, and extension support.
BCMS MCP
Give me a one - two sentence description of the BCMS MCP # MCP The BCMS Model Context Protocol (MCP) integration enables AI assistants like Claude, Cursor, and other MCP-compatible tools to interact directly with your BCMS content. This allows you to create, read, and update content entries, manage media files, and explore your content structure—all through natural language conversations with AI. ## What is MCP? The [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) is an open standard developed by Anthropic that allows AI applications to securely connect to external data sources and tools. With BCMS MCP support, you can leverage AI assistants to: - Query and explore your content structure - Create new content entries with AI-generated content - Update existing entries - Manage your media library - Get intelligent suggestions based on your content model --- ## Getting Started ### Prerequisites 1. A BCMS account with an active instance 2. An MCP key with appropriate permissions 3. An MCP-compatible client (Claude Desktop, Cursor, or any MCP client) ### Step 1: Create an MCP Key 1. Navigate to your BCMS dashboard 2. Go to Settings → MCP 3. Click Create MCP Key 4. Configure the permissions for templates you want the AI to access:GET: Read entries 5. POST: Create entries 6. PUT: Update entries 7. DELETE: Delete entries Note: Right now, MCP only supports creating, reading and updating content. ### Step 2: Configure Your MCP Client You can find full instructions for integrating BCMS with your AI tools right inside BCMS, on the MCP page. But in general, installing BCMS MCP works in a standard way: ``` { "mcpServers": { "bcms": { "url": "https://app.thebcms.com/api/v3/mcp?mcpKey=YOUR_MCP_KEY" } } } ``` ## Available Tools Once connected, your AI assistant will have access to the following tools based on your MCP key permissions: ### Content Discovery #### list_templates_and_entries Lists all templates and their entries that you have access to. This is typically the first tool to call when exploring your BCMS content. Returns: - Template IDs, names, and slugs - Entry IDs with titles and slugs for each language Example prompt: "Show me all the templates and entries in my BCMS" --- ### Entry Management #### list_entries_for_{templateId} Retrieves all entries for a specific template with full content data. A separate tool is generated for each template you have access to. Returns: - Complete entry data including all meta fields - Content in all configured languages - Entry statuses Example prompt: "List all blog posts from my Blog template" --- #### create_entry_for_{templateId} Creates a new entry for a specific template. The input schema is dynamically generated based on your template's field structure. Input: - statuses: Array of status assignments per language - meta: Array of metadata for each language (title, slug, custom fields) - content: Array of content nodes for each language Example prompt: "Create a new blog post titled 'Getting Started with BCMS' with a brief introduction paragraph" --- #### update_entry_for_{templateId} Updates an existing entry for a specific language. Input: - entryId: The ID of the entry to update - lng: Language code (e.g., "en") - status: Optional status ID - meta: Updated metadata - content: Updated content nodes Example prompt: "Update the introduction paragraph of my 'Getting Started' blog post" --- ### Media Management #### list_all_media Lists all media files in your media library. Returns: - Media IDs, names, and types - File metadata (size, dimensions for images) - Parent directory information Example prompt: "Show me all images in my media library" --- #### list_media_dirs Lists the directory structure of your media library. Returns: - Hierarchical directory structure - Directory IDs and names Example prompt: "Show me the folder structure of my media library" --- #### create-media-directory Creates a new directory in your media library. Input: - name: Name of the directory - parentId: Optional parent directory ID (root if not specified) Example prompt: "Create a new folder called 'Blog Images' in my media library" --- #### request-upload-media-url Returns a URL you use to upload a file (for example via POST with multipart form data), which avoids pushing large binaries through the MCP tool payload. You still need a valid file name and MIME type when uploading, as described in the tool response. Availability: Only when the MCP key has Can mutate media enabled. Example prompt: “Give me an upload URL for a new hero image, then tell me how to upload it.” Input: - fileName: Name of the file with extension - fileData: Base64-encoded file data (with data URI prefix) - parentId: Optional parent directory ID Example prompt: "Upload this image to my Blog Images folder" --- ### Linking Tools #### get_entry_pointer_link Generates an internal BCMS link to an entry for use in content. Input: - entryId: The ID of the entry to link to Returns: - Internal link format: entry:{entryId}@*_{templateId}:entry Example prompt: "Get me the internal link for the 'About Us' page entry" --- #### get_media_pointer_link Generates an internal BCMS link to a media item for use in content. Input: - mediaId: The ID of the media item Returns: - Internal link format: media:{mediaId}@*_@*_:entry Example prompt: "Get the link for the hero image so I can use it in my blog post" --- ## Content Structure ### Entry Content Nodes When creating or updating entries, content is structured as an array of nodes. Supported node types include: Type Description paragraph Standard text paragraph heading Heading (h1-h6) bulletList Unordered list orderedList Numbered list listItem List item codeBlock Code block with syntax highlighting blockquote Quote block image Image node widget Custom widget with props ### Example Content Structure ``` { "content": [ { "lng": "en", "nodes": [ { "type": "heading", "attrs": { "level": 1 }, "content": [ { "type": "text", "text": "Welcome to BCMS" } ] }, { "type": "paragraph", "content": [ { "type": "text", "text": "This is your first paragraph." } ] } ] } ] } ``` ## Security & Permissions ### MCP Key Scopes Your MCP key controls what the AI can access: - Template Access: Only templates explicitly granted in the MCP key are visible - Operation Permissions: Each template can have independent GET/POST/PUT/DELETE permissions - Media Access: Media operations are controlled separately ### Best Practices 1. Principle of Least Privilege: Only grant the permissions needed for your use case 2. Separate Keys: Create different MCP keys for different purposes or team members 3. Regular Rotation: Periodically rotate your MCP keys ## Use Cases ### Content Creation Workflows Blog Post Creation "Create a new blog post about the benefits of headless CMS. Include an introduction, three main benefits with explanations, and a conclusion. Use the Blog template." Product Updates "Update the price field for all products in the Electronics category to apply a 10% discount" ### Content Exploration Content Audit "List all blog posts that don't have a featured image set" Translation Status "Show me which entries are missing German translations" ### Media Organization Library Cleanup "Show me all unused images in the media library" Folder Setup "Create folder structure for: Products > Categories > Electronics, Clothing, Home" ## Troubleshooting ### Common Issues #### "MCP key not found" - Verify your MCP key format: keyId.keySecret.instanceId - Ensure the MCP key hasn't been deleted or deactivated - Check that you're using the correct instance #### "MCP key does not have access to template" - Review your MCP key permissions in the dashboard - Ensure the required operation (GET/POST/PUT/DELETE) is enabled for the template #### Session Expired - MCP sessions may timeout after periods of inactivity - Simply start a new conversation to establish a fresh session ### Getting Help - Documentation: [thebcms.com/docs](https://thebcms.com/docs) - Support: [[email protected]](mailto:[email protected]) - Community: [Join BCMS Discord](https://discord.com/invite/SYBY89ccaR) for community support ## Technical Reference ### Endpoint POST https://app.thebcms.com/api/v3/mcp?mcpKey={MCP_KEY} ### Transport BCMS MCP uses the Streamable HTTP transport with session management. Sessions are maintained via the mcp-session-id header. ### Response Format All tools return structured JSON responses conforming to the MCP specification with: - content: Array of content blocks - structuredContent: Typed response data ## Rate Limits MCP requests are subject to the same rate limits as API requests: - Requests are tracked per MCP key - Contact support if you need higher limits for production workloads
Manual Tests MCP Server
A YAML-based server for managing manual test cases with tools for test automation workflows.
Adios MCP
A remote MCP server deployable on Cloudflare Workers without authentication.
SkyDeckAI Code
A comprehensive toolkit for AI-driven development, offering file system operations, code analysis, execution, web searching, and system information retrieval.