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 connecting this server to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-06-24 · ★ 3 · #507 OF 848 MAINTAINED OTHER · VERIFIED 2026-08-25

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, 10 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. ★ 7

05 · Facts

repository: github.com/flyfish-dev/file-ai
website: https://github.com/flyfish-dev/file-ai
category: other - ranked #507 of 848 actively-maintained other servers as of 2026-08-25.
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-08-25, 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 · Server MCP Registry

More TypeScript MCP servers · Spec Driven Development · see all