Content
# 🔥 ALAPI MCP Server
[](https://smithery.ai/server/@ALAPI-SDK/mcp-alapi-cn)
This is an MCP (Model Context Protocol) server implementation based on [ALAPI](https://www.alapi.cn). It can directly call ALAPI's interfaces through the MCP protocol, making it easy to integrate ALAPI's rich API resources into various AI applications that support MCP.
## ✨ Features
- 🔍 **Rich API Resources** - Provides 100+ common API services such as IP query, weather query, hot search list, and enterprise information.
- 🧩 **MCP Protocol Support** - Fully compatible with Model Context Protocol, easy to integrate into various AI applications.
- 🔄 **Automatic Loading** - Automatically loads ALAPI OpenAPI specifications without manual configuration.
- 🎯 **Flexible Calling** - Supports loading all or specified APIs for on-demand use (short video parsing, weather query, 60-second daily world news, enterprise query, etc.).
- 🛡️ **Unified Response** - Provides unified error handling and response format to simplify the development process.
- ⚙️ **Configurability** - Supports environment variable configuration, easily adaptable to different usage scenarios.
## 📖 Usage Guide
First, you need to understand the [MCP](https://modelcontextprotocol.io/introduction) protocol, and then add the ALAPI MCP service according to the following configuration.
## Using in MCP Client
ALAPI MCP Server is designed to work with clients that support the MCP protocol and does not support independent command-line configuration. Follow these steps to configure and use it in your MCP client:
### Method 1: Remote MCP
This project supports [one-click deployment to Tencent Cloud Development Platform](https://docs.cloudbase.net/ai/mcp/develop/host-mcp), providing remote SSE access.
[☁️ Go to Cloud Development Platform to deploy MCP Server](https://tcb.cloud.tencent.com/dev#/ai?tab=mcp&p&mcp-template=mcp-alapi-cn)
### Method 2: Automatic Installation with Smithery
Install ALAPI MCP Server via [Smithery](https://smithery.ai/server/@ALAPI-SDK/mcp-alapi-cn), suitable for Claude Desktop client:
```bash
npx -y @smithery/cli install @ALAPI-SDK/mcp-alapi-cn --client claude
```
### Method 3: Directly Use Pre-compiled Binary Files (Recommended, No Dependency Installation Required)
1. Visit the [Releases page](https://github.com/ALAPI-SDK/mcp-alapi-cn/releases) to download the latest version
> Domestic accelerated download address: https://cnb.cool/alapi/mcp-alapi-cn/-/releases
2. Select the latest version corresponding to your operating system:
- Windows: `mcp-alapi-cn.exe`
- macOS: `mcp-alapi-cn-macos`
- Linux: `mcp-alapi-cn-linux`
3. Configure in an MCP-enabled client (such as Claude Desktop):
- Open the MCP client settings
- Add a new MCP server
- Specify the downloaded binary file path
- Configure the necessary environment variables (such as `ALAPI_TOKEN`)
### Configure Environment Variables
#### `ALAPI_TOKEN` - ALAPI Platform Access Token (Required)
You need to configure the [TOKEN](https://www.alapi.cn/dashboard/data/token) that you created on the ALAPI platform for interface authentication.
### MCP Client Configuration Example
In Claude Desktop or other MCP-enabled clients, you can refer to the following configuration:
#### JSON Configuration (Using Local Binary File)
```json
{
"mcpServers": {
"alapi": {
"path": "/path/to/mcp-alapi-cn",
"env": {
"ALAPI_TOKEN": "token created on the ALAPI platform"
}
}
}
}
```
### Supported MCP Clients
According to the [MCP documentation](https://modelcontextprotocol.io/clients), the following clients support MCP tool integration:
- Claude Desktop App
- Claude Code
- Cursor
- Continue
- Cline
- And other clients that support the MCP protocol
> Note: Make sure your MCP client supports tool integration, please refer to the specific documentation of each client for configuration.
## 🛠️ Supported Features
The following are some of the supported features. The complete features are subject to actual calls:
| Feature Name | Description |
|---|---|
| IP Query | Query IP attribution information, supports IPv4 and IPv6 |
| Weather Query | Query domestic weather details, including weather information, weather warnings, weather index, AQI, etc. |
| Today's Hot List | Query today's hot list data, including Douyin hot search, Toutiao hot list, Zhihu, 36k, Baidu hot search, Weibo hot search, etc. |
| Text Moderation | Query whether the text is in violation, especially suitable for AI content moderation |
| Short URL | Short URL shortening, shorten long URLs to short URLs, convenient for SMS sending, QR code generation and other scenarios |
| QR Code Recognition | Supports multiple codes in one image, supports the recognition of dozens of two-dimensional codes and barcodes |
| Today in History | Query major events that occurred on a specified date in history |
| Exchange Rate Query | Query currency exchange rates and conversions based on currency codes, supporting currency queries in 170+ countries and regions around the world |
| Enterprise Query | Query basic industrial and commercial information of enterprises based on enterprise name or unified social credit code |
| Express Query | Free query of express logistics tracking, supporting ZTO, STO, SF, J&T, Best, YTO, etc. |
| Horoscope | Provide horoscope query service, support query of the horoscope of the twelve constellations today or tomorrow, this week, this month, this year |
| Gold Price | Query the real-time price of current gold, the highest price, the lowest price, and the price of branded gold |
## 🔗 Related Links
- [ALAPI Official Website](https://www.alapi.cn) - Get API services and Token
- [MCP Protocol Documentation](https://modelcontextprotocol.io) - Learn more about MCP protocol related information
## 🙏 Acknowledgements
- [ALAPI](https://www.alapi.cn) - Provides powerful API support
- [Model Context Protocol](https://modelcontextprotocol.io) - Provides protocol standards
