Content
# @erliban/office-mcp-server
<div align="center">
**🔥 AI-Powered Professional Document Generation MCP Server**
[](https://www.npmjs.com/package/@erliban/office-mcp-server)
[](https://opensource.org/licenses/MIT)
[](https://nodejs.org/)
*8 Document Themes | 6 Mermaid Chart Styles | China National Standards Compliant*
[English](#english) | [中文](#中文)
</div>
---
<a name="english"></a>
## English
### ✨ Core Features
| Feature | Description |
|---------|-------------|
| **🎯 Professional Documents** | Compliant with GB/T 9704-2012 (Government), GB/T 8567-2006 (Software) standards |
| **🎨 Multiple Themes** | 8 document themes + 6 Mermaid chart color schemes |
| **📊 Mermaid Diagrams** | Auto-convert flowcharts, sequence diagrams to PNG images |
| **🤖 AI Native** | Designed for Claude, ChatGPT via MCP protocol |
| **⚡ Ready to Use** | One command to start |
### 📦 Quick Start
#### Installation
```bash
npm install -g @erliban/office-mcp-server
```
#### Claude Desktop Configuration
Add to `claude_desktop_config.json`:
```json
{
"mcpServers": {
"office": {
"command": "npx",
"args": ["@erliban/office-mcp-server"]
}
}
}
```
**Config file location**:
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
### 🎨 Document Themes
#### Standard Themes
| Theme | Name | Use Case | Standard |
|-------|------|----------|----------|
| `government` | Government | Official documents | GB/T 9704-2012 |
| `academic` | Academic | Thesis, research | Academic standards |
| `software` | Software | Requirements, design docs | GB/T 8567-2006 |
| `business` | Business | Reports, proposals | Enterprise standards |
#### Brand Themes
| Theme | Name | Color | Industry |
|-------|------|-------|----------|
| `alibaba` | Alibaba | Orange | E-commerce |
| `tencent` | Tencent | Green | Social, Finance |
| `bytedance` | ByteDance | Black | Tech, Media |
| `minimal` | Minimal | B&W | Universal |
### 📊 Mermaid Chart Themes
| Theme | Name | Color | Best For |
|-------|------|-------|----------|
| `professional` | Professional | Blue #4a90d9 | Technical docs |
| `fresh` | Fresh | Green #52c41a | Flowcharts |
| `business` | Business | Gray #595959 | Formal reports |
| `tech` | Tech | Purple #722ed1 | Product docs |
| `warm` | Warm | Orange #fa8c16 | Proposals |
| `default` | Default | Mermaid default | General |
### 🛠️ Available Tools
#### Word Tools
| Tool | Description |
|------|-------------|
| `word_create` | Create Word document |
| `word_add_heading` | Add heading |
| `word_add_paragraph` | Add paragraph |
| `word_add_table` | Add table |
| `word_add_list` | Add list |
| `word_add_code` | Add code block |
| `word_add_diagram` | Add Mermaid diagram |
| `word_save` | Save document |
#### Excel Tools
| Tool | Description |
|------|-------------|
| `excel_create` | Create workbook |
| `excel_add_sheet` | Add worksheet |
| `excel_write_data` | Write data |
| `excel_add_chart` | Add chart |
| `excel_save` | Save workbook |
---
<a name="中文"></a>
## 中文
### ✨ 核心优势
| 特性 | 描述 |
|------|------|
| **🎯 专业级文档** | 严格遵循 GB/T 9704-2012（公文）、GB/T 8567-2006（软件文档）等国家标准 |
| **🎨 多主题支持** | 8 种预设文档风格 + 6 种 Mermaid 图表配色，覆盖政府、学术、企业全场景 |
| **📊 Mermaid 图表** | AI 自动识别并将流程图、时序图等转换为专业 PNG 图片嵌入文档 |
| **🤖 AI 原生** | 专为 Claude、ChatGPT 等 AI 设计，通过 MCP 协议无缝集成 |
| **⚡ 开箱即用** | 无需复杂配置，一行命令即可启动服务 |
### 📦 快速开始
#### 安装
```bash
npm install -g @erliban/office-mcp-server
```
#### Claude Desktop 配置
将以下配置添加到 `claude_desktop_config.json`：
```json
{
"mcpServers": {
"office": {
"command": "npx",
"args": ["@erliban/office-mcp-server"]
}
}
}
```
**配置文件位置**：
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
#### 指定输出目录（推荐）
```json
{
"mcpServers": {
"office": {
"command": "npx",
"args": ["@erliban/office-mcp-server"],
"env": {
"OUTPUT_DIR": "/Users/yourname/Documents/生成文档"
}
}
}
}
```
### 🎯 推荐 Prompt
将以下内容添加到 Claude 的系统提示或项目 CLAUDE.md 中：
```markdown
## Office 文档生成规范
使用 @erliban/office-mcp-server 生成专业文档时遵循以下规则：
### 文档主题选择
- **党政公文** → theme: "government" (GB/T 9704-2012 标准)
- **学术论文/研究报告** → theme: "academic"
- **软件需求/设计文档** → theme: "software" (GB/T 8567-2006 标准)
- **商业计划书/工作汇报** → theme: "business"
- **电商/零售行业** → theme: "alibaba"
- **社交/金融行业** → theme: "tencent"
- **科技/媒体行业** → theme: "bytedance"
- **通用正式文档** → theme: "minimal"
### Mermaid 图表转换
当文档中包含架构图、流程图时：
1. 使用 word_add_diagram 工具将 Mermaid 语法转为图片
2. 根据文档类型选择合适的图表主题：
- 技术文档 → diagramTheme: "professional"
- 流程图 → diagramTheme: "fresh"
- 正式报告 → diagramTheme: "business"
- 产品文档 → diagramTheme: "tech"
- 产品方案 → diagramTheme: "warm"
### 生成流程
1. word_create → 创建文档（指定主题）
2. word_add_heading → 添加标题层级
3. word_add_paragraph → 添加正文内容
4. word_add_table → 添加数据表格
5. word_add_diagram → 添加 Mermaid 图表
6. word_add_list → 添加列表
7. word_save → 保存文档
```
### 🎨 文档主题一览
#### 标准规范主题
| 主题 | 名称 | 适用场景 | 参考标准 |
|------|------|---------|---------|
| `government` | 党政公文 | 政府机关、国企公文 | GB/T 9704-2012 |
| `academic` | 学术论文 | 毕业论文、研究报告 | 学术论文规范 |
| `software` | 软件文档 | 需求规格、设计文档 | GB/T 8567-2006 |
| `business` | 商务报告 | 商业计划书、工作汇报 | 企业文档规范 |
#### 企业品牌主题
| 主题 | 名称 | 主色调 | 适用行业 |
|------|------|--------|---------|
| `alibaba` | 阿里风格 | 橙色系 | 电商、零售 |
| `tencent` | 腾讯风格 | 绿色系 | 社交、金融 |
| `bytedance` | 字节风格 | 黑色系 | 科技、媒体 |
| `minimal` | 简约黑白 | 黑白 | 通用正式场合 |
### 📊 Mermaid 图表主题
AI 可自动识别文档中的 Mermaid 语法并转换为专业图片：
| 主题 | 名称 | 主色调 | 推荐场景 |
|------|------|--------|---------|
| `professional` | 专业蓝 | 蓝色 #4a90d9 | 技术文档、API 文档 |
| `fresh` | 清新绿 | 绿色 #52c41a | 流程图、状态图 |
| `business` | 商务灰 | 灰色 #595959 | 正式报告、提案 |
| `tech` | 科技紫 | 紫色 #722ed1 | 产品文档、架构图 |
| `warm` | 暖橙色 | 橙色 #fa8c16 | 产品方案、营销文档 |
| `default` | 默认 | Mermaid 默认 | 通用场景 |
**支持的 Mermaid 图表类型**：
- `flowchart` - 流程图
- `sequenceDiagram` - 时序图
- `stateDiagram` - 状态图
- `classDiagram` - 类图
- `erDiagram` - ER 图
- `gantt` - 甘特图
- `pie` - 饼图
### 🛠️ 可用工具
#### Word 文档工具
| 工具名 | 描述 | 关键参数 |
|--------|------|---------|
| `word_create` | 创建 Word 文档 | `theme`: 主题名称 |
| `word_add_heading` | 添加标题 | `level`: 1-3, `text`: 标题文本 |
| `word_add_paragraph` | 添加段落 | `text`: 段落内容 |
| `word_add_table` | 添加表格 | `headers`, `rows`: 表格数据 |
| `word_add_list` | 添加列表 | `items`, `ordered`: 有序/无序 |
| `word_add_code` | 添加代码块 | `code`, `language`: 语言类型 |
| `word_add_diagram` | 添加 Mermaid 图表 | `mermaid`, `theme`, `width` |
| `word_add_image` | 添加图片 | `path`, `width`: 宽度(cm) |
| `word_save` | 保存文档 | `path`: 保存路径 |
#### Excel 表格工具
| 工具名 | 描述 | 关键参数 |
|--------|------|---------|
| `excel_create` | 创建工作簿 | `theme`: 主题名称 |
| `excel_add_sheet` | 添加工作表 | `name`: 表名 |
| `excel_write_data` | 写入数据 | `data`: 二维数组 |
| `excel_add_chart` | 添加图表 | `type`, `dataRange` |
| `excel_add_formula` | 添加公式 | `cell`, `formula` |
| `excel_save` | 保存工作簿 | `path`: 保存路径 |
### 💡 使用示例
#### 示例 1：生成软件需求文档
```
帮我生成一份用户管理模块的需求规格说明书，使用软件文档主题。包含：
1. 功能概述
2. 用户角色和权限表格
3. 用例流程图（使用 Mermaid）
4. 接口定义
```
#### 示例 2：生成产品分析报告
```
帮我写一份 AI 智能音箱的产品方案分析，使用字节风格。需要包含：
- 产品架构图
- 技术选型对比表
- 成本估算
```
---
## 🔧 Development | 开发
```bash
# Clone | 克隆
git clone https://github.com/jiahuidegit/office-mcp-server.git
cd office-mcp-server
# Install | 安装依赖
npm install
# Dev mode | 开发模式
npm run dev
# Build | 构建
npm run build
# Test | 测试
npm test
```
---
## 📄 License
MIT © [Erliban](https://github.com/erliban)
