让开源，少一点语言距离。
npm包中文文档

@freeflow-im/mcp-docs

中文文档
0.2.38发布于 2026/11/03UNLICENSEDES Module零依赖构建来源已验证近 30 天下载 2848

Install the MCP Docs desktop app and its plugin for Claude Code and Codex: office files on your Mac or Windows PC, edited by your coding agent or any MCP client.

原始使用文档
中文原文

@freeflow-im/mcp-docs

Installs MCP Docs, a Mac and Windows app for Word, PowerPoint and Excel files, Markdown, CSV, PDFs and pictures in a folder on your computer, and the mcp-docs plugin for Claude Code and Codex, which lets your coding agent open and edit those files while you watch them change in the app. Any other MCP client can connect to the app too.

npx @freeflow-im/mcp-docs

This:

  1. Downloads the latest MCP Docs release from GitHub and puts it in /Applications (or ~/Applications), replacing an older version. On Windows it runs the release's setup program, which installs it for you.
  2. For each of Claude Code and Codex it finds, asks whether to add the mcp-docs plugin, and if so adds the mcp-docs plugin marketplace and installs the plugin: the app's MCP server and a skill describing how to use it.
  3. Starts the app, and prints its MCP address, http://127.0.0.1:39217/mcp.

Then sign in once: in Claude Code, restart it, run /mcp and sign in to plugin:mcp-docs:mcp-docs; in Codex, run codex mcp login mcp-docs. The app asks you to allow each agent. Run npx @freeflow-im/mcp-docs again to update everything.

Any other MCP client can connect to http://127.0.0.1:39217/mcp (streamable HTTP) while the app is running. It signs in with OAuth 2.1 (dynamic client registration and PKCE), and the app asks you to allow it.

Options: --claude, --codex (add the plugin to these agents without asking, and not to the others), --yes (add it to every agent found without asking), --skip-app (plugins only), --skip-plugins (app only).

To remove it all again:

npx @freeflow-im/mcp-docs --uninstall

This removes the app, its data and settings (the assistant's chats, API keys, connected agents) and what it added to Claude Code (the plugin, its marketplace, and an mcp-docs server added by hand) and to Codex (the plugin and its marketplace). It lists what it will remove and asks first (--yes skips the question). Your documents, in the folders you opened, are not touched.

Requires a Mac with Apple silicon or Windows (x64), and Node.js 18 or later.

版本与发布记录

@freeflow-im/mcp-docs 共发布 15 个版本，首次发布于 2026/10/24；过去 12 个月发布了 15 个版本。最新版本附带 npm provenance 构建来源证明，可追溯到公开的 CI 构建记录。

版本发布日期距今
0.2.38latest2026/11/0312 天前
0.2.372026/10/3115 天前
0.2.362026/10/3116 天前
0.2.352026/10/2917 天前
0.2.342026/10/2918 天前
0.2.332026/10/2918 天前

关于 @freeflow-im/mcp-docs 的常见问题

@freeflow-im/mcp-docs 是什么？

Install the MCP Docs desktop app and its plugin for Claude Code and Codex: office files on your Mac or Windows PC, edited by your coding agent or any MCP client.

如何安装 @freeflow-im/mcp-docs？

在项目目录运行 npm install @freeflow-im/mcp-docs，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mcp-docs，可以用 npx mcp-docs 直接运行。

@freeflow-im/mcp-docs 支持 TypeScript 吗？

该包的 package.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/freeflow-im__mcp-docs 是否存在。

@freeflow-im/mcp-docs 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module，更早的版本需要改用动态 import()。

@freeflow-im/mcp-docs 需要什么版本的 Node.js？

package.json 的 engines 字段要求 Node.js >=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

@freeflow-im/mcp-docs 可以商用吗？

@freeflow-im/mcp-docs 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

@freeflow-im/mcp-docs 的下载量有多少？

根据 npm 官方下载统计，@freeflow-im/mcp-docs 在 2026/10/16 – 2026/11/14 这 30 天内被下载 2,848 次，日均约 95 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

@freeflow-im/mcp-docs 还在维护吗？

最新版本 0.2.38 发布于 2026/11/03（12 天前）；至今共发布 15 个版本，其中过去 12 个月发布了 15 个；首次发布于 2026/10/24。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。