aliyun-sls-mcp 0.1.0

package/README.md

@@ -0,0 +1,342 @@
+# aliyun-sls-mcp
+
+阿里云日志服务（SLS）的 MCP Server，让 AI 助手（Cursor、Claude Desktop 等）能够直接查询 SLS 日志，辅助开发过程中的问题排查与分析。
+
+**只读模式，不执行任何写入或删除操作。**
+
+[English](./README.en.md) | [GitHub](https://github.com/SuxyEE/aliyun-sls-mcp) | [npm](https://www.npmjs.com/package/aliyun-sls-mcp)
+
+## 功能特性
+
+- **列出项目** — 按地域动态发现所有 SLS Project，无需手动配置项目列表
+- **列出日志库** — 浏览 Project 下的所有 Logstore
+- **查询日志** — 支持时间范围 + SLS 查询语法过滤，适合错误排查
+- **SQL 分析** — 对日志做聚合、统计、分组分析
+- **日志分布图** — ASCII 柱状图展示某时间段内的日志量分布，快速定位异常时间窗口
+- **上下文日志** — 获取某条日志前后的日志，还原完整执行链路
+
+---
+
+## 快速开始（npx 方式）
+
+> 推荐方式，无需克隆代码，配置完成后即可使用。
+
+### 第一步：获取阿里云 AccessKey
+
+前往 [RAM 访问控制台](https://ram.console.aliyun.com/manage/ak) 创建 AccessKey，并为对应 RAM 用户授予以下权限：
+
+```
+AliyunLogReadOnlyAccess
+```
+
+### 第二步：配置 MCP
+
+**Cursor**：编辑 `~/.cursor/mcp.json`（Windows: `%USERPROFILE%\.cursor\mcp.json`）
+
+**Claude Desktop**：编辑 `~/Library/Application Support/Claude/claude_desktop_config.json`（Windows: `%APPDATA%\Claude\claude_desktop_config.json`）
+
+```json
+{
+  "mcpServers": {
+    "aliyun-sls": {
+      "command": "npx",
+      "args": ["-y", "aliyun-sls-mcp"],
+      "env": {
+        "ALIBABA_CLOUD_ACCESS_KEY_ID": "your_access_key_id",
+        "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "your_access_key_secret",
+        "SLS_REGION": "cn-hangzhou"
+      }
+    }
+  }
+}
+```
+
+### 第三步：重启 AI 客户端
+
+重启 Cursor 或 Claude Desktop，即可在对话中直接查询 SLS 日志。
+
+---
+
+## 本地开发 / 源码运行
+
+适合希望二次开发或尚未发布到 npm 时使用。
+
+### 克隆并构建
+
+```bash
+git clone https://github.com/your-name/aliyun-sls-mcp.git
+cd aliyun-sls-mcp
+npm install
+npm run build
+```
+
+### 配置 MCP（本地路径方式）
+
+```json
+{
+  "mcpServers": {
+    "aliyun-sls": {
+      "command": "node",
+      "args": ["/path/to/aliyun-sls-mcp/dist/index.js"],
+      "env": {
+        "ALIBABA_CLOUD_ACCESS_KEY_ID": "your_access_key_id",
+        "ALIBABA_CLOUD_ACCESS_KEY_SECRET": "your_access_key_secret",
+        "SLS_REGION": "cn-hangzhou"
+      }
+    }
+  }
+}
+```
+
+Windows 路径示例：
+
+```json
+"args": ["e:\\tools\\aliyun-sls-mcp\\dist\\index.js"]
+```
+
+### 本地验证
+
+```bash
+node dist/index.js
+# 输出: Aliyun SLS MCP Server running on stdio
+```
+
+---
+
+## 环境变量
+
+| 变量名 | 是否必填 | 说明 |
+|--------|----------|------|
+| `ALIBABA_CLOUD_ACCESS_KEY_ID` | ✅ 必填 | 阿里云 AccessKey ID |
+| `ALIBABA_CLOUD_ACCESS_KEY_SECRET` | ✅ 必填 | 阿里云 AccessKey Secret |
+| `SLS_REGION` | 可选 | 默认地域，如 `cn-hangzhou`。所有工具调用时可通过 `region` 参数单独覆盖 |
+| `SLS_NETWORK` | 可选 | 网络类型：`public`（默认，公网）或 `vpc`（VPC 私网） |
+
+> **多地域支持**：只需配置一个默认地域，所有工具均支持通过 `region` 参数动态切换到任意地域的项目，无需为每个地域单独部署。
+
+---
+
+## 可用工具
+
+### `list_projects` — 列出项目
+
+列出指定地域下的所有 SLS Project。
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `region` | string | 否 | 地域 ID，默认使用 `SLS_REGION` |
+
+---
+
+### `list_logstores` — 列出日志库
+
+列出某个 Project 下的所有 Logstore。
+
+| 参数 | 类型 | 必填 | 说明 |
+|------|------|------|------|
+| `project` | string | ✅ | SLS Project 名称 |
+| `region` | string | 否 | 地域 ID |
+
+---
+
+### `query_logs` — 查询日志
+
+按时间范围和过滤条件查询日志，适合错误排查、接口追踪等场景。
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| `project` | string | ✅ | — | SLS Project 名称 |
+| `logstore` | string | ✅ | — | Logstore 名称 |
+| `query` | string | 否 | `*` | SLS 查询语句 |
+| `time_range` | string | 否 | `15m` | 相对时间范围 |
+| `from` | number | 否 | — | 开始时间（Unix 秒），优先于 `time_range` |
+| `to` | number | 否 | — | 结束时间（Unix 秒） |
+| `max_logs` | number | 否 | `50` | 最多返回条数（1-500） |
+| `region` | string | 否 | — | 地域 ID |
+
+**时间范围格式：** `1m` `5m` `15m` `30m` `1h` `2h` `6h` `12h` `1d` `3d` `7d`
+
+**SLS 查询语法示例：**
+
+```
+*                              # 所有日志
+level: ERROR                   # 错误级别日志
+content: timeout               # 包含 timeout 的日志
+level: ERROR AND status: 500   # 组合条件
+NOT level: INFO                # 排除 INFO 日志
+requestId: abc-123             # 按请求 ID 追踪
+```
+
+---
+
+### `query_logs_sql` — SQL 分析
+
+对日志执行 SQL 查询，支持聚合、统计、分组，适合趋势分析和问题统计。
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| `project` | string | ✅ | — | SLS Project 名称 |
+| `query` | string | ✅ | — | SQL 语句，FROM 子句指定 Logstore 名称 |
+| `time_range` | string | 否 | `1h` | 时间范围 |
+| `from` | number | 否 | — | 开始时间（Unix 秒） |
+| `to` | number | 否 | — | 结束时间（Unix 秒） |
+| `region` | string | 否 | — | 地域 ID |
+
+**SQL 示例：**
+
+```sql
+-- 按函数名统计调用量
+SELECT functionName, count(*) as total
+FROM default-logs
+WHERE __time__ > 1700000000
+GROUP BY functionName
+ORDER BY total DESC
+
+-- 统计各状态码数量
+SELECT statusCode, count(*) as cnt
+FROM default-logs
+WHERE __time__ > 1700000000 AND statusCode != ''
+GROUP BY statusCode
+ORDER BY cnt DESC
+```
+
+---
+
+### `get_log_histogram` — 日志分布图
+
+获取某段时间内日志量的分钟级分布，以 ASCII 柱状图展示，用于快速定位流量异常或错误高峰时间点。
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| `project` | string | ✅ | — | SLS Project 名称 |
+| `logstore` | string | ✅ | — | Logstore 名称 |
+| `query` | string | 否 | `*` | 过滤条件 |
+| `time_range` | string | 否 | `1h` | 时间范围 |
+| `from` | number | 否 | — | 开始时间（Unix 秒） |
+| `to` | number | 否 | — | 结束时间（Unix 秒） |
+| `region` | string | 否 | — | 地域 ID |
+
+**输出示例：**
+
+```
+2026/3/19 11:03:00  ███████████████████░░░░░░░░░░░  1996
+2026/3/19 11:04:00  ███████████████████████░░░░░░░  2379  ← 流量高峰
+2026/3/19 11:05:00  ████████████████░░░░░░░░░░░░░░  1670
+```
+
+---
+
+### `get_context_logs` — 上下文日志
+
+获取某条日志前后的若干条日志，还原事件发生前后的完整执行链路。
+
+> 需要日志包含 `__tag__:__pack_meta__` 字段。阿里云 FC 函数计算的日志通常没有该字段，可改用 `query_logs` 按 `__tag__:__pack_id__` 过滤同一批次的日志。
+
+| 参数 | 类型 | 必填 | 默认值 | 说明 |
+|------|------|------|--------|------|
+| `project` | string | ✅ | — | SLS Project 名称 |
+| `logstore` | string | ✅ | — | Logstore 名称 |
+| `pack_id` | string | ✅ | — | 目标日志的 `__tag__:__pack_id__` 字段值 |
+| `pack_meta` | string | ✅ | — | 目标日志的 `__tag__:__pack_meta__` 字段值 |
+| `back_lines` | number | 否 | `10` | 向前获取的条数（最大 100） |
+| `forward_lines` | number | 否 | `10` | 向后获取的条数（最大 100） |
+| `region` | string | 否 | — | 地域 ID |
+
+---
+
+## 对话使用示例
+
+```
+列出深圳地域所有 SLS 项目
+
+查询 my-project 项目 app-logs 日志库最近 15 分钟的错误日志
+
+查看 my-project 最近 1 小时的日志量分布，找出流量高峰时间点
+
+统计 my-project 最近 1 小时各函数的调用量
+
+查询 cn-shanghai 地域 payment-project 项目 order-logs 中包含 timeout 的日志
+
+帮我排查 2026-03-19 11:00 到 11:30 之间 xyjapi 函数出现的 SLOW SQL 问题
+```
+
+---
+
+## 支持的地域
+
+### 亚太
+
+| 地域名称 | 地域 ID |
+|----------|---------|
+| 华北1（青岛） | `cn-qingdao` |
+| 华北2（北京） | `cn-beijing` |
+| 华北3（张家口） | `cn-zhangjiakou` |
+| 华北5（呼和浩特） | `cn-huhehaote` |
+| 华北6（乌兰察布） | `cn-wulanchabu` |
+| 华东1（杭州） | `cn-hangzhou` |
+| 华东2（上海） | `cn-shanghai` |
+| 华东5（南京-本地地域） | `cn-nanjing` |
+| 华东6（福州-本地地域） | `cn-fuzhou` |
+| 华南1（深圳） | `cn-shenzhen` |
+| 华南2（河源） | `cn-heyuan` |
+| 华南3（广州） | `cn-guangzhou` |
+| 西南1（成都） | `cn-chengdu` |
+| 中国香港 | `cn-hongkong` |
+| 日本（东京） | `ap-northeast-1` |
+| 韩国（首尔） | `ap-northeast-2` |
+| 新加坡 | `ap-southeast-1` |
+| 马来西亚（吉隆坡） | `ap-southeast-3` |
+| 印度尼西亚（雅加达） | `ap-southeast-5` |
+| 菲律宾（马尼拉） | `ap-southeast-6` |
+| 泰国（曼谷） | `ap-southeast-7` |
+
+### 欧洲与美洲
+
+| 地域名称 | 地域 ID |
+|----------|---------|
+| 美国（硅谷） | `us-west-1` |
+| 美国（弗吉尼亚） | `us-east-1` |
+| 美国（亚特兰大） | `us-southeast-1` |
+| 德国（法兰克福） | `eu-central-1` |
+| 英国（伦敦） | `eu-west-1` |
+
+### 中东
+
+| 地域名称 | 地域 ID |
+|----------|---------|
+| 沙特（利雅得） | `me-central-1` |
+| 阿联酋（迪拜） | `me-east-1` |
+
+### 行业云
+
+| 地域名称 | 地域 ID |
+|----------|---------|
+| 华北2 金融云 | `cn-beijing-finance-1` |
+| 华东1 金融云 | `cn-hangzhou-finance` |
+| 华东2 金融云 | `cn-shanghai-finance-1` |
+| 华南1 金融云 | `cn-shenzhen-finance-1` |
+| 河源专属云（汽车合规） | `cn-heyuan-acdr-1` |
+
+> 完整接入点列表参见[阿里云 SLS 服务接入点文档](https://help.aliyun.com/zh/sls/developer-reference/service-entrance)。
+
+---
+
+## 技术栈
+
+- **语言**：TypeScript
+- **运行时**：Node.js >= 18
+- **MCP SDK**：`@modelcontextprotocol/sdk` ^1.27.1
+- **SLS SDK**：`@alicloud/sls20201230` ^5.9.0
+
+## 本地开发
+
+```bash
+npm install        # 安装依赖
+npm run dev        # 监听变化自动编译
+npm run build      # 构建
+npm start          # 运行
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,116 @@
+#!/usr/bin/env node
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { listProjectsSchema, handleListProjects } from './tools/list-projects.js';
+import { listLogStoresSchema, handleListLogStores } from './tools/list-logstores.js';
+import { queryLogsSchema, handleQueryLogs } from './tools/query-logs.js';
+import { queryLogsSQLSchema, handleQueryLogsSQL } from './tools/query-logs-sql.js';
+import { getLogHistogramSchema, handleGetLogHistogram } from './tools/get-log-histogram.js';
+import { getContextLogsSchema, handleGetContextLogs } from './tools/get-context-logs.js';
+const TOOLS = [
+    {
+        name: 'list_projects',
+        description: 'List all SLS projects in the specified Alibaba Cloud region. Use this to discover available projects before querying logs.',
+        inputSchema: zodToJsonSchema(listProjectsSchema),
+    },
+    {
+        name: 'list_logstores',
+        description: 'List all logstores within an SLS project. Use this to discover available logstores before querying logs.',
+        inputSchema: zodToJsonSchema(listLogStoresSchema),
+    },
+    {
+        name: 'query_logs',
+        description: 'Query log data from an SLS logstore with a time range and optional filter query. Returns formatted log entries. Use for debugging, error investigation, and log analysis. Supports SLS query syntax like "level: ERROR", "content: timeout", "status: 500 AND method: POST".',
+        inputSchema: zodToJsonSchema(queryLogsSchema),
+    },
+    {
+        name: 'query_logs_sql',
+        description: 'Execute a SQL query against an SLS project for log analysis and aggregation. Best for counting, grouping, statistical analysis. Example: "SELECT status, count(*) as cnt FROM <logstore> WHERE __time__ > 1700000000 GROUP BY status".',
+        inputSchema: zodToJsonSchema(queryLogsSQLSchema),
+    },
+    {
+        name: 'get_log_histogram',
+        description: 'Get the time-series distribution of log counts matching a query. Returns a visual histogram showing log volume over time. Useful for identifying when errors spiked or when unusual activity occurred.',
+        inputSchema: zodToJsonSchema(getLogHistogramSchema),
+    },
+    {
+        name: 'get_context_logs',
+        description: 'Retrieve log lines before and after a specific log entry using its pack_id and pack_meta. First query logs with query_logs to find a log entry, then use its __tag__:__pack_id__ and __tag__:__pack_meta__ fields to get surrounding context. Useful for understanding full execution flow around an error.',
+        inputSchema: zodToJsonSchema(getContextLogsSchema),
+    },
+];
+const server = new Server({
+    name: 'aliyun-sls-mcp',
+    version: '0.1.0',
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return { tools: TOOLS };
+});
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        let text;
+        switch (name) {
+            case 'list_projects': {
+                const input = listProjectsSchema.parse(args);
+                text = await handleListProjects(input);
+                break;
+            }
+            case 'list_logstores': {
+                const input = listLogStoresSchema.parse(args);
+                text = await handleListLogStores(input);
+                break;
+            }
+            case 'query_logs': {
+                const input = queryLogsSchema.parse(args);
+                text = await handleQueryLogs(input);
+                break;
+            }
+            case 'query_logs_sql': {
+                const input = queryLogsSQLSchema.parse(args);
+                text = await handleQueryLogsSQL(input);
+                break;
+            }
+            case 'get_log_histogram': {
+                const input = getLogHistogramSchema.parse(args);
+                text = await handleGetLogHistogram(input);
+                break;
+            }
+            case 'get_context_logs': {
+                const input = getContextLogsSchema.parse(args);
+                text = await handleGetContextLogs(input);
+                break;
+            }
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+        return {
+            content: [{ type: 'text', text }],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: `Error: ${message}` }],
+            isError: true,
+        };
+    }
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    process.stderr.write('Aliyun SLS MCP Server running on stdio\n');
+}
+process.on('SIGINT', () => process.exit(0));
+process.on('SIGTERM', () => process.exit(0));
+main().catch((err) => {
+    process.stderr.write(`Fatal error: ${err}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/sls-client.d.ts

@@ -0,0 +1,74 @@
+export interface SlsConfig {
+    accessKeyId: string;
+    accessKeySecret: string;
+    region: string;
+    network?: 'public' | 'vpc';
+}
+export interface LogEntry {
+    [key: string]: string;
+}
+export interface QueryLogsResult {
+    logs: LogEntry[];
+    count: number;
+    processedRows?: number;
+    hasMore: boolean;
+    progress?: string;
+}
+export interface LogHistogram {
+    from: number;
+    to: number;
+    count: number;
+    progress: string;
+}
+export interface ContextLogsResult {
+    logs: LogEntry[];
+    backCount: number;
+    forwardCount: number;
+}
+export declare function listProjects(region?: string): Promise<{
+    projectName: string;
+    description: string;
+    region: string;
+}[]>;
+export declare function listLogStores(project: string, region?: string): Promise<{
+    logstoreName: string;
+}[]>;
+export declare function queryLogs(params: {
+    project: string;
+    logstore: string;
+    query: string;
+    from: number;
+    to: number;
+    maxLogs?: number;
+    region?: string;
+}): Promise<QueryLogsResult>;
+export declare function queryLogsBySQL(params: {
+    project: string;
+    query: string;
+    from: number;
+    to: number;
+    region?: string;
+}): Promise<QueryLogsResult>;
+export declare function getLogHistogram(params: {
+    project: string;
+    logstore: string;
+    query: string;
+    from: number;
+    to: number;
+    region?: string;
+}): Promise<LogHistogram[]>;
+export declare function getContextLogs(params: {
+    project: string;
+    logstore: string;
+    packId: string;
+    packMeta: string;
+    backLines?: number;
+    forwardLines?: number;
+    region?: string;
+}): Promise<ContextLogsResult>;
+export declare function parseTimeRange(timeStr: string): {
+    from: number;
+    to: number;
+};
+export declare function formatTimestamp(unixSeconds: number): string;
+//# sourceMappingURL=sls-client.d.ts.map

package/dist/sls-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sls-client.d.ts","sourceRoot":"","sources":["../src/sls-client.ts"],"names":[],"mappings":"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"}