README.md•2.39 kB
# Aliyun MCP Server
This MCP server provides tools for interacting with Aliyun (Alibaba Cloud) services through Claude.
## Features
- Query SLS (Simple Log Service) logs
- (Future) Manage ECS instances
- (Future) Deploy serverless functions
## Configuration
1. Build the server:
```bash
npm install
npm run build
```
### Usage with Claude Desktop
Add the server to your claude_desktop_config.json:
```json
{
"mcpServers": {
"aliyun": {
"command": "node",
"args": ["/path/to/aliyun-mcp-server/build/index.js"],
"env": {
"ALIYUN_ACCESS_KEY_ID": "your-access-key-id",
"ALIYUN_ACCESS_KEY_SECRET": "your-access-key-secret",
"SLS_ENDPOINT": "cn-hangzhou.log.aliyuncs.com"
},
"disabled": false,
"autoApprove": []
}
}
}
```
### Configuration for Cline
Add the server to your Cline MCP settings file inside VSCode's settings `cline_mcp_settings.json`
```json
{
"mcpServers": {
"aliyun": {
"command": "node",
"args": ["/path/to/aliyun-mcp-server/build/index.js"],
"env": {
"ALIYUN_ACCESS_KEY_ID": "your-access-key-id",
"ALIYUN_ACCESS_KEY_SECRET": "your-access-key-secret",
"SLS_ENDPOINT": "cn-hangzhou.log.aliyuncs.com"
},
"disabled": false,
"autoApprove": []
}
}
}
```
Replace `/path/to/aliyun-mcp-server` with the actual path to this repository, and provide your Aliyun credentials.
## Usage
Once configured, you can ask Claude to query SLS logs:
```
Query SLS logs from project "my-project" and logstore "my-logstore" with the query "error" for the last hour.
```
Claude will use the MCP server to execute the query and return the results.
## Available Tools
### querySLSLogs
Query Aliyun SLS (Simple Log Service) logs.
Parameters:
- `project` (required): SLS project name
- `logstore` (required): SLS logstore name
- `query` (required): SLS query statement
- `from` (optional): Start time in milliseconds (defaults to 1 hour ago)
- `to` (optional): End time in milliseconds (defaults to now)
- `limit` (optional): Maximum number of logs to return (default: 100, max: 1000)
- `offset` (optional): Offset for pagination (default: 0)
- `reverse` (optional): Whether to return results in reverse order (default: false)
Example:
```json
{
"project": "my-project",
"logstore": "my-logstore",
"query": "error",
"limit": 10
}