Built-in Office document tools (OfficeCLI integration)
维护者通常 1 天内回复
还没有人认领这个 Issue。
评估
调研方向
This is a design proposal, so start by reading how the existing pieces fit: LocalAIAssistantHolder and metadata.localai_assistant, DisableMutating in pkg/mcp/localaitools, and the MCP executor functions NewToolExecutor, DiscoverMCPTools, ExecuteTool and ExecuteMCPToolCallRemote. Done means maintainers agree on the modality shape, lifecycle, and sandboxing, not that code exists yet. Do not start an implementation until that is settled in the thread.
由索引模型根据 Issue 内容生成。
描述
Is your feature request related to a problem?
LocalAI models and agents cannot create or edit Office documents (.docx/.xlsx/.pptx) locally. Users must manually configure an external MCP server per model or per agent.
Describe the solution
I don't know if anybody thinked about before, but my proposal is to integrate OfficeCLI (Apache 2.0, single self-contained binary, built-in MCP stdio server + HTML/PNG rendering engine) as an optional built-in tool surface, following the existing LocalAI Assistant pattern:
- In-process / managed MCP surface — analogous to
LocalAIAssistantHolder+metadata.localai_assistant: anofficemodality (e.g.metadata.office_documentsor aDisableOfficeToolsapp flag) that registers OfficeCLI's MCP tools for any model without per-model YAML. - Lifecycle management — LocalAI provisions/launches the
officeclistdio server itself (auto-download binary or bundled), instead of requiring users to hand-write anmcp.stdioblock. - Agent integration — expose the same surface to the Agent pool as a built-in action / default agent-scoped MCP server, respecting
allowed_tools,excluded_toolsand a read-only mode (mirroringDisableMutatinginpkg/mcp/localaitools). - Skill prompt injection — reuse the MCP prompt-injection path to surface OfficeCLI's SKILL.md guidance to the model when the modality is active.
Why it fits
- The existing MCP executor (
NewToolExecutor,DiscoverMCPTools,ExecuteTool) already supports stdio servers and the server-side tool loop across /v1/chat/completions, Anthropic Messages, Open Responses (stream + background). - OfficeCLI's MCP tool has a single
commandstring param — trivially compatible with the genericCallToolpath. - Distributed mode: the tool would execute on agent workers via
ExecuteMCPToolCallRemote, so the binary only needs to exist on worker nodes.
Workaround today
Manually adding OfficeCLI as mcp.stdio in the model YAML or as an agent-scoped stdio server — but this requires installing the binary yourself and repeating the config per model/agent.
Security considerations
- File-system access should be sandboxed/scoped (configurable working dir).
- Read-only mode (view/get/query/validate only) for untrusted contexts.
- Disabled by default, opt-in flag — same posture as the LocalAI Assistant.
Other considerations
Integrate office features is so important to a professional and enterprise use of LocalAI.
- 主要语言
- Go
- 星标
- 49.5k
- 派生
- 4.5k
- 平均合并
- 23 小时 15 分钟
- 30 天内合并 PR
- 382
环境准备
在浏览器里用你自己的 GitHub 账号启动这个项目的开发容器。
- 提供 Dockerfile 或 Docker Compose 文件
- 有 Pull Request 模板
- 阅读贡献指南
从这里开始
- 先读完整个 Issue，再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库，在一个分支上完成修改。
- 提交 Pull Request，并在描述里引用这个 Issue 编号。
mudler/LocalAI 的其他 Issue
-
bug unconfirmed
难度 2/5 1-3 小时 新手友好度 67/100
维护者通常 1 天内回复
-
Open Responses API doesn't accept "output_text" as an input Item可能已有人在做 @localai-org-maint-bot 于 18 天前认领。 未关闭bug unconfirmed
难度 2/5 1-3 小时 新手友好度 78/100
mudler/LocalAI#12337 · 1 条评论 ·
维护者通常 1 天内回复
-
Gallery model audio-cpp-sortformer-diarization fails to install: SHA mismatch, reproducible across retries可能重新可做 关联的 PR 已关闭且未合并。 未关闭
难度 2/5 1-3 小时 新手友好度 76/100
mudler/LocalAI#11995 · 1 条评论 ·
维护者通常 1 天内回复
-
Agent pool Postgres DSN is logged in cleartext, including the password, while the auth DSN is redacted可能已有人在做 @localai-org-maint-bot 于 35 天前认领。 未关闭
难度 2/5 1-3 小时 新手友好度 75/100
mudler/LocalAI#11991 · 1 条评论 ·
维护者通常 1 天内回复
-
fish-speech: make compile:true usable on Blackwell sm_121 by honouring the CUDA toolkit's ptxas可能重新可做 关联的 PR 已关闭且未合并。 未关闭enhancement
难度 2/5 1-3 小时 新手友好度 76/100
mudler/LocalAI#11348 · 1 条评论 ·
维护者通常 1 天内回复
相似的 Issue
-
clawsweeper:fix-shape-clear clawsweeper:queueable-fix clawsweeper:source-repro impact:session-state issue-rating: 🦞 diamond lobster no-stale P2
难度 2/5 1-3 小时 新手友好度 74/100
openclaw/wacli#503 · 1 条评论 · 1 个 reaction ·
维护者通常 1 天内回复
-
难度 2/5 1-3 小时 新手友好度 81/100
apache/rocketmq-dashboard#6895 ·
维护者通常 3 天内回复
-
agent-butler-finding chore
难度 1/5 1 小时以内 新手友好度 88/100
jordansmall/spindrift#5466 ·
维护者通常 1 天内回复
-
难度 1/5 1 小时以内 新手友好度 92/100
open-telemetry/opentelemetry-go-compile-instrumentation#1507 ·
维护者通常 3 天内回复
-
难度 1/5 1 小时以内 新手友好度 87/100
777genius/agent-notifications#490 ·
维护者通常 1 天内回复