┌─────────────┐   JSON-RPC over stdio   ┌──────────────┐
│  AI agent   │ ◀─────────────────────▶ │  office-mcp  │
│ (MCP 客户端) │   initialize/tools/call │   server.py  │
└─────────────┘                         └──────┬───────┘
                                               │
                                    ┌──────────┴──────────┐
                                    ▼                     ▼
                              python-docx           openpyxl
                              python-pptx           pymupdf

pip install -r requirements.txt

python server.py --selftest "D:\某处\报告.docx"

{
  "mcpServers": {
    "office": {
      "command": "python",
      "args": ["D:\\path\\to\\office-mcp\\server.py"]
    }
  }
}

python examples/test_client.py

[id=1] initialize -> {'name': 'office-mcp', 'version': '1.0.0'} 协议 2024-11-05
[id=2] tools/list -> 4 个工具: ['doc_read', 'sheet_read', 'slide_read', 'pdf_extract']

[id=3] ✅ 返回 631 字符:
     # 家庭用电分析报告.docx
     （家庭用电分析报告.docx：53 段、3 表）
     | 报告名称 | 家庭用电情况分析报告 |

# 一条请求进来
{"jsonrpc": "2.0", "id": 3, "method": "tools/call",
 "params": {"name": "doc_read", "arguments": {"path": "报告.docx"}}}

# 一条响应出去
{"jsonrpc": "2.0", "id": 3,
 "result": {"content": [{"type": "text", "text": "# 报告.docx\n…"}], "isError": false}}

IN  <<< {"method":"server/discover","params":{"_meta":{
             "io.modelcontextprotocol/protocolVersion":"2026-07-28", ...}}}
OUT >>> {"error":{"code":-32601,"message":"不支持的方法: server/discover"}}

IN  <<< {"method":"initialize","params":{"protocolVersion":"2025-11-25", ...}}
OUT >>> {"protocolVersion":"2024-11-05","capabilities":{"tools":{}}, ...}

IN  <<< {"jsonrpc":"2.0","method":"notifications/initialized"}
IN  <<< {"method":"tools/list","jsonrpc":"2.0","id":1}
OUT >>> {"id":1,"result":{"tools":[{"name":"doc_read", ...}]}}

'gbk' codec can't encode character '\u2705' in position 22

for stream in (sys.stdout, sys.stderr):
    stream.reconfigure(encoding="utf-8", errors="replace", newline="\n")

# 万一 reconfigure 没生效，就退化成纯 ASCII 输出（中文变 \uXXXX 转义）
ascii_only = (sys.stdout.encoding or "").lower().replace("-", "") != "utf8"
json.dumps(payload, ensure_ascii=ascii_only)

is_notification = "id" not in request
...
if is_notification:
    return None

- insert:
    - id: office-mcp
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: office
        transport: stdio
        command: '<装了依赖的那个 python 绝对路径>'
        args:
          - '<server.py 的绝对路径>'
        failOnStartupError: true

        env:
          OFFICE_MCP_DEBUG: '1'

IN <<< {"method":"tools/call", ...}
OUT >>> {"jsonrpc":"2.0","id":2,"result":{"content":[...]}}

for child in document.element.body.iterchildren():
    tag = child.tag.split("}")[-1]
    if tag == "p":    ...Paragraph(child, document)
    elif tag == "tbl": ...Table(child, document)

openpyxl.load_workbook(path, data_only=True)

…（已截断，原文 24311 字符，只返回前 8000 字符）