aibiao-excel-mcp-server/README.md

专为aibiao.cn定制的AI Excel操作MCP服务器 - 让AI智能分析和处理Excel数据

# aibiao-excel-mcp-server

🚀 **专为aibiao.cn定制的AI Excel操作MCP服务器** - 让AI智能分析和处理Excel数据

[![npm version](https://badge.fury.io/js/aibiao-excel-mcp-server.svg)](https://badge.fury.io/js/aibiao-excel-mcp-server)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## ✨ 特性

- 🔥 **智能Excel分析** - AI驱动的Excel数据处理和分析
- 💬 **聊天式交互** - 通过自然语言操作Excel文件
- 📊 **图表生成** - 自动创建数据可视化图表
- 🔄 **工作流管理** - 可重用的数据处理自动化流程
- 🌐 **MCP协议** - 兼容Model Context Protocol标准
- ⚡ **高性能** - 优化的数据处理和响应速度

## 🚀 快速开始

### 安装

```bash
# 全局安装
npm install -g aibiao-excel-mcp-server

# 或者使用npx直接运行
npx aibiao-excel-mcp-server
```

### 使用

```bash
# 直接运行
aibiao-mcp

# 或者设置环境变量后运行
export AIBIAO_API_KEY="your-api-key"
export AIBIAO_BASE_URL="https://aibiao.cn"
aibiao-mcp
```

## 🔧 配置

### 环境变量

| 变量名 | 描述 | 默认值 |
|--------|------|--------|
| `AIBIAO_API_KEY` | 你的aibiao.cn API密钥 | `""` |
| `AIBIAO_BASE_URL` | API基础URL | `https://aibiao.cn` |

### 获取API密钥

在使用此MCP服务之前，你需要先获取aibiao.cn的API密钥：

1. 访问 [https://aibiao.cn/public/api-key](https://aibiao.cn/public/api-key)
2. 注册并登录你的账户
3. 在控制台中生成API密钥
4. 将API密钥设置为环境变量

### 配置文件

你也可以创建 `.env` 文件来配置：

```env
AIBIAO_API_KEY=your-api-key-here
AIBIAO_BASE_URL=https://aibiao.cn
```

## 🛠️ 可用工具

### 系统管理
- `query_api_key_status` - 查询API Key状态和使用额度

### 聊天管理
- `create_chat` - 创建新的AI Excel分析聊天会话
- `append_chat` - 向聊天会话追加新问题
- `list_chats` - 查询所有聊天会话列表
- `get_chat` - 获取单个聊天会话详情
- `update_chat_title` - 修改聊天会话标题
- `delete_chat` - 删除聊天会话

### 图表管理
- `create_chat` - 基于Excel文件创建智能图表
- `list_charts` - 查询所有图表列表
- `delete_chart` - 删除指定图表

### 工作流管理
- `save_workflow` - 将聊天记录保存为可重用工作流
- `list_workflows` - 查询所有工作流模板
- `execute_workflow` - 执行工作流模板
- `update_workflow_name` - 修改工作流名称和描述
- `delete_workflow` - 删除工作流模板

## 🔌 MCP集成

这个服务器完全兼容Model Context Protocol (MCP)，可以轻松集成到支持MCP的AI应用中。

### 测试体验

使用MCP Inspector来测试和体验功能：

```bash
npx @modelcontextprotocol/inspector -e AIBIAO_API_KEY=your-api-key -e AIBIAO_BASE_URL=https://aibiao.cn
```

### MCP客户端配置

#### Cursor配置

在Cursor的MCP配置文件中添加：

```json
{
  "mcpServers": {
    "aibiao-excel": {
      "command": "npx",
      "args": ["aibiao-excel-mcp-server"],
      "env": {
        "AIBIAO_API_KEY": "your-api-key",
        "AIBIAO_BASE_URL": "https://aibiao.cn"
      }
    }
  }
}
```

#### 其他MCP客户端

```json
{
  "mcpServers": {
    "aibiao-excel": {
      "command": "aibiao-excel-mcp-server",
      "env": {
        "AIBIAO_API_KEY": "your-api-key",
        "AIBIAO_BASE_URL": "https://aibiao.cn"
      }
    }
  }
}
```

## 📝 许可证

MIT License - 详见 [LICENSE](LICENSE) 文件

## 📞 支持

- 🌐 网站：https://aibiao.cn
- 📖 API文档：https://aibiao.cn/public/api-key
- 📧 邮箱：待完善

---

⭐ 如果这个项目对你有帮助，请给我们一个星标！