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), which allows direct calls to 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 over 100 commonly used API services, including IP queries, weather queries, trending lists, and company information.
- 🧩 **MCP Protocol Support** - Fully compatible with the Model Context Protocol, easily integrated into various AI applications.
- 🔄 **Automatic Loading** - Automatically loads the ALAPI OpenAPI specification without manual configuration.
- 🎯 **Flexible Invocation** - Supports loading all or specified APIs for on-demand use (such as short video parsing, weather queries, understanding the world in 60 seconds daily, company queries, etc.).
- 🛡️ **Unified Response** - Provides a unified error handling and response format, simplifying the development process.
- ⚙️ **Configurability** - Supports environment variable configuration, easily adapting to different usage scenarios.
## 📖 Usage Guide
First, familiarize yourself with the [MCP](https://modelcontextprotocol.io/introduction) protocol, and then follow the configuration steps to add the ALAPI MCP service.
## Using in MCP Client
The ALAPI MCP Server is designed to work with clients that support the MCP protocol and does not support standalone command-line configuration. Please follow the steps below to configure 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: Use Smithery for Automatic Installation
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: Use Precompiled Binary Files Directly (Recommended, no dependencies to install)
1. Visit the [Releases page](https://github.com/ALAPI-SDK/mcp-alapi-cn/releases) to download the latest version.
> Domestic accelerated download link: https://cnb.cool/alapi/mcp-alapi-cn/-/releases
2. Choose the corresponding latest version based on your operating system:
- Windows: `mcp-alapi-cn.exe`
- macOS: `mcp-alapi-cn-macos`
- Linux: `mcp-alapi-cn-linux`
3. Configure in a client that supports MCP (such as Claude Desktop):
- Open MCP client settings
- Add a new MCP server
- Specify the path to the downloaded binary file
- Configure necessary environment variables (such as `ALAPI_TOKEN`)
### Configuring Environment Variables
#### `ALAPI_TOKEN` - ALAPI Platform Access Token (Required)
This needs to be configured with the [TOKEN](https://www.alapi.cn/dashboard/data/token) you created on the ALAPI platform for interface authentication.
### MCP Client Configuration Example
In Claude Desktop or other MCP-supported 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": "The 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: Ensure that your MCP client supports tool integration features; please refer to the specific documentation of each client for configuration.
## 🛠️ Supported Features
Here are some of the supported features; please refer to actual calls for the complete functionality:
| Feature Name | Description |
| -------------- | ---------------------------------------------------------------------------- |
| IP Query | Queries IP location information, supporting both IPv4 and IPv6 |
| Weather Query | Queries domestic weather details, including weather information, alerts, indices, AQI, etc. |
| Today's Hot List | Queries today's hot list data, including Douyin hot searches, Toutiao hot list, Zhihu, 36Kr, Baidu hot searches, Weibo hot searches, etc. |
| Text Review | Checks whether the text violates regulations, especially suitable for AI content review |
| Short URL | Shortens long URLs into short URLs for easy SMS sending, QR code generation, etc. |
| QR Code Recognition | Supports multiple codes in one image, recognizing dozens of QR codes and barcodes |
| On This Day | Queries significant events that occurred on a specified date in history |
| Exchange Rate | Queries currency exchange rates and conversions based on currency codes, supporting over 170 countries and regions |
| Company Query | Queries basic business information based on company name or unified social credit code |
| Express Query | Free query of express logistics tracking, supporting ZTO, Shentong, SF, Jitu, Best, YTO, etc. |
| Horoscope | Provides horoscope query services, supporting queries for today's or tomorrow's, this week's, this month's, and this year's horoscopes for the twelve zodiac signs |
| Gold Price | Queries the current real-time price of gold, highest price, lowest price, and brand gold prices |
## 🔗 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 information
## 🙏 Acknowledgments
- [ALAPI](https://www.alapi.cn) - Provides powerful API support
- [Model Context Protocol](https://modelcontextprotocol.io) - Provides protocol standards
