File AI MCP Server

Read-only document awareness MCP server for agents. File AI uses Flyfish File Viewer core as the source of truth for format recognition, then turns local files into a stable profile, anchors, blocks, chunks, outline, search results, and contextual snippets so an agent can understand document content without reverse-engineering PDF, OOXML, spreadsheet, email, or archive internals. Its README documents 5 tools, including doc_analyze, doc_read, doc_search.

People who work with document ai and file viewer and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-06-24 · ★ 3 · #526 OF 945 MAINTAINED OTHER · VERIFIED 2026-09-18

Apache-2.0 · TypeScript servers · how we verify → /methodology

01 · Install File AI

Claude Code

claude mcp add flyfish-dev-file-ai -- npx -y @flyfish-dev/file-ai

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "flyfish-dev-file-ai": {
      "command": "npx",
      "args": [
        "-y",
        "@flyfish-dev/file-ai"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license Apache-2.0 - declared in the repository

npm package @flyfish-dev/file-ai - published under the repo owner's npm scope (@flyfish-dev)

registry namespace io.github.flyfish-dev is GitHub-verified and matches the repo owner

03 · What File AI can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can parse a local file and cache a document index, read blocks, chunks, or anchors from an existing index or path, search cached content with source anchors, and retrieve nearby blocks around an anchor or query.

The 5 tools it gives your agent

Extracted from the project's README - what File AI lets an agent do.

doc_analyze: - parse a local file and cache a document index.
doc_read: - read blocks, chunks, or anchors from an existing index or path.
doc_search: - search cached content with source anchors.
doc_context: - retrieve nearby blocks around an anchor or query.
doc_list_formats: - list File Viewer core registry formats, all supported extensions, renderer capabilities, and File AI extractor coverage.

04 · Who maintains File AI

File AI is maintained by flyfish-dev. We track 2 MCP servers from flyfish-dev - 2 actively maintained, 12 combined GitHub stars, oldest repo from Jun 2026. Full record: all servers from flyfish-dev.

Word AI Structure-preserving Word DOCX editing MCP server and Office.js bridge for AI agents. ★ 9

05 · Facts

repository: github.com/flyfish-dev/file-ai
website: https://github.com/flyfish-dev/file-ai
category: other - ranked #526 of 945 actively-maintained other servers as of 2026-09-18.
registry: io.github.flyfish-dev/file-ai (active, first published 2026-06-24)
packages: npm:@flyfish-dev/file-ai

06 · File AI FAQ

Is File AI still maintained?

Yes - as of 2026-09-18, its last commit was 2026-06-24. We re-verify nightly.

What can File AI do?

How do I install File AI?

Run `npx -y @flyfish-dev/file-ai`. You can also paste the ready-made client config above.

Does File AI run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to File AI

Alternatives to File AI

Maintained other servers if File AI isn't the fit.

More MCP servers to compare · Word AI · Eds MCP Server · Formio MCP · Code Runner · MINT Protocol - Universal Work Attestation

More TypeScript MCP servers · Islam West Africa Collection (IWAC) · Aso Audit MCP · see all