File AI MCP server
✓ VerifiziertErmöglicht KI-Agenten strukturiertes Dokumentenverständnis, indem lokale Dateien in durchsuchbare Profile, Anker und kontextuelle Snippets umgewandelt werden.
Auch bekannt als flyfish-dev/file-ai, file-ai, @flyfish-dev/file-ai
- Stars
- 3
- Tools
- 5
- Downloads, 30 Tage
- 189
- Neueste Version
- 0.1.1
- Letzter Commit
- 24. Juni 2026
- Lizenz
- Apache-2.0
Was ist File AI MCP?
Ermöglicht KI-Agenten strukturiertes Dokumentenverständnis, indem lokale Dateien in durchsuchbare Profile, Anker und kontextuelle Snippets umgewandelt werden. Er stellt 5 Tools bereit, etwa doc_analyze, doc_read, doc_search.
Zusammenfassung generiert aus dem README des Projekts
Über File AI MCP server
File AI verleiht KI-Agenten ein strukturiertes Verständnis lokaler Dokumente, indem es Dateien in durchsuchbare Profile, Anker und kontextuelle Snippets umwandelt. Es fungiert als Read-only-Layer, der verhindert, dass Agenten komplexe Dateistrukturen wie PDF, OOXML oder Tabellenkalkulationen mühsam selbst analysieren müssen. Entwickler können den Server lokal über npx ausführen oder ihn global via npm installieren, um den stdio-Transport zu nutzen. Er unterstützt zudem einen streamable HTTP-Transport auf einem festgelegten Host und Port.
Der Server nutzt den Flyfish File Viewer Core für die Formaterkennung von 206 registrierten Erweiterungen. Er bietet spezifische Tools wie doc_analyze zum Parsen und Cachen von Indizes, doc_read für den Zugriff auf Blöcke oder Chunks sowie doc_search, um Inhalte mit Source-Ankern zu finden. Zudem sind doc_context zum Abrufen von Surrounding-Text und doc_list_formats zur Überprüfung unterstützter Erweiterungen und Renderer-Funktionen enthalten. Während er tiefe Extraktion für Text, Code, Markdown, JSON, PDF, DOCX, XLSX, CSV, PPTX und EML bietet, kann er auch Metadaten und Warnungen für andere Formate wie CAD- oder Mediendateien zurückgeben.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du File AI MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenFile AI MCP in Claude Code installieren
$ claude mcp add file-ai -- npx -y @flyfish-dev/file-aiFile AI MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"file-ai": {
"command": "npx",
"args": [
"-y",
"@flyfish-dev/file-ai"
]
}
}
}File AI MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"file-ai": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@flyfish-dev/file-ai"
]
}
}
}File AI MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"file-ai","type":"stdio","command":"npx","args":["-y","@flyfish-dev/file-ai"]}'File AI MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"file-ai": {
"command": "npx",
"args": [
"-y",
"@flyfish-dev/file-ai"
]
}
}
}File AI MCP in Codex installieren
$ codex mcp add file-ai -- npx -y @flyfish-dev/file-aiFile AI MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.file-ai] command = "npx" args = ["-y", "@flyfish-dev/file-ai"]
File AI MCP in Gemini CLI installieren
$ gemini mcp add -s user file-ai npx -- -y @flyfish-dev/file-aiFile AI MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"file-ai": {
"command": "npx",
"args": [
"-y",
"@flyfish-dev/file-ai"
]
}
}
}File AI MCP tools 5
Erkannt aus dem READMEdoc_analyzedoc_readdoc_searchdoc_contextdoc_list_formats
| doc_analyze | — | |
| doc_read | — | |
| doc_search | — | |
| doc_context | — | |
| doc_list_formats | — |
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarflyfish-dev/file-ai is public and reachablegithub.com/flyfish-dev/file-ai ↗Bestanden
- Paket nennt dieses Repository als Quelle@flyfish-dev/file-ai names flyfish-dev/file-ai as sourcenpmjs.com/package/@flyfish-dev/file-ai ↗Bestanden
- Build-Provenienz (Sigstore-Attestierung)No build attestation published for this releaseNicht geprüft
- Open Source Lizenz (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-06-24github.com/flyfish-dev/file-ai ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNo popular package one edit away from @flyfish-dev/file-aiBestanden
- Keine kritischen Advisories im Paket oder seinen Abhängigkeiten154 resolved dependencies checked; no critical advisoryosv.dev ↗Bestanden
- Keine versteckten Anweisungen an das Modell5 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNo tool named like delete, drop or execBestanden
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenFile AI
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.
MCP Registry name: io.github.flyfish-dev/file-ai
Install
Use it directly with npx:
npx -y @flyfish-dev/file-ai
Or install it globally:
npm install -g @flyfish-dev/file-ai
file-ai --transport stdio
MCP Client Config
Stdio:
{
"mcpServers": {
"file-ai": {
"command": "npx",
"args": ["-y", "@flyfish-dev/file-ai"]
}
}
}
Streamable HTTP:
npx -y @flyfish-dev/file-ai --transport http --host 127.0.0.1 --port 8765
Endpoint:
http://127.0.0.1:8765/mcp
Tools
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.
Resources
doc://{indexId}/profiledoc://{indexId}/outlinedoc://{indexId}/chunks
Supported Files
File AI recognizes formats through @file-viewer/core/headless, currently covering 206 registered extensions. profile.format is therefore aligned with the same renderer selection used by Flyfish File Viewer.
Content extraction is a separate layer. File AI provides structured awareness for text/code/Markdown/JSON, PDF text, DOCX, XLSX/CSV, PPTX, EML, and archive manifests. Other File Viewer renderer-only formats such as CAD, 3D, media, image, geospatial, drawing, ebook, and data assets are still recognized in profile.format; when no structured text extractor exists yet, File AI returns a profile plus best-effort metadata/text and explicit warnings in profile.warnings and profile.extraction.
Every content block carries an anchor such as a page, slide, worksheet, row range, nested path, or byte/text location. Agents should cite returned anchorId values when making document-grounded claims.
Development
pnpm install
pnpm build
pnpm test
pnpm validate:skill
Run locally:
pnpm dev -- --transport stdio
pnpm dev -- --transport http --port 8765
Publishing
The package includes:
- npm metadata for
@flyfish-dev/file-ai - MCP Registry metadata in
server.json - GitHub Actions workflow
.github/workflows/publish-mcp.yml
Release flow:
git tag v0.1.0
git push origin v0.1.0
The workflow publishes the npm package first, then publishes io.github.flyfish-dev/file-ai to the official MCP Registry through GitHub OIDC. The repository must have an NPM_TOKEN secret that can publish @flyfish-dev/file-ai.
The server is read-only. It does not mutate source documents.
File AI MCP Fragen
Wie füge ich File AI MCP zu Claude Code hinzu?
Führe claude mcp add file-ai -- npx -y @flyfish-dev/file-ai in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich File AI MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Welche Tools bietet File AI MCP?
Er stellt 5 Tools bereit, darunter doc_analyze, doc_read, doc_search, doc_context, doc_list_formats.
Verändert File AI meine lokalen Dateien?
Nein, der Server ist read-only und verändert deine Quelldokumente nicht.
Welche Dateiformate werden unterstützt?
Es werden über 206 Erweiterungen unterstützt, darunter Text, Code, Markdown, JSON, PDF, DOCX, XLSX/CSV, PPTX, EML und Archiv-Manifeste.