MCP server de File AI
✓ VerificadoProporciona a los agentes de IA conciencia estructurada de documentos al convertir archivos locales en perfiles buscables, anclajes y fragmentos contextuales.
También conocido como flyfish-dev/file-ai, file-ai, @flyfish-dev/file-ai
- Stars
- 3
- Herramientas
- 5
- Descargas, 30 días
- 189
- Última versión
- 0.1.1
- Último commit
- 24 jun 2026
- Licencia
- Apache-2.0
¿Qué es File AI MCP?
Proporciona a los agentes de IA conciencia estructurada de documentos al convertir archivos locales en perfiles buscables, anclajes y fragmentos contextuales. Expone 5 herramientas, como doc_analyze, doc_read, doc_search.
Resumen generado a partir del README del proyecto
Acerca del MCP server de File AI
File AI proporciona a los agentes de IA una comprensión estructurada de los documentos locales al convertir archivos en perfiles buscables, anclajes y fragmentos contextuales. Funciona como una capa de solo lectura que evita que los agentes tengan que realizar ingeniería inversa en la estructura interna de archivos complejos como PDF, OOXML o hojas de cálculo. Los desarrolladores pueden ejecutar el servidor localmente usando npx o instalarlo globalmente vía npm para usar el transporte stdio. También admite un transporte streamable HTTP en un host y puerto específicos.
El servidor utiliza el núcleo Flyfish File Viewer para el reconocimiento de formatos en 206 extensiones registradas. Ofrece herramientas específicas como doc_analyze para el análisis y almacenamiento en caché de índices, doc_read para acceder a bloques o fragmentos, y doc_search para encontrar contenido con anclajes de origen. También incluye doc_context para recuperar el texto circundante y doc_list_formats para verificar las extensiones compatibles y las capacidades del renderizador. Aunque ofrece una extracción profunda para texto, código, Markdown, JSON, PDF, DOCX, XLSX, CSV, PPTX y EML, también puede devolver metadatos y advertencias para otros formatos como archivos CAD o multimedia.
Escrito a partir del README del proyecto. Cada caso de uso se verifica con una cita del mismo.
Cómo instalar File AI MCP
Formatos verificados el 10 nov 2026Añadir a CursorAñadir a GooseInstalar File AI MCP en Claude Code
$ claude mcp add file-ai -- npx -y @flyfish-dev/file-aiInstalar File AI MCP en Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"file-ai": {
"command": "npx",
"args": [
"-y",
"@flyfish-dev/file-ai"
]
}
}
}Instalar File AI MCP en VS Code
.vscode/mcp.json
{
"servers": {
"file-ai": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@flyfish-dev/file-ai"
]
}
}
}Instalar File AI MCP en VS Code CLI
$ code --add-mcp '{"name":"file-ai","type":"stdio","command":"npx","args":["-y","@flyfish-dev/file-ai"]}'Instalar File AI MCP en Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"file-ai": {
"command": "npx",
"args": [
"-y",
"@flyfish-dev/file-ai"
]
}
}
}Instalar File AI MCP en Codex
$ codex mcp add file-ai -- npx -y @flyfish-dev/file-aiInstalar File AI MCP en Codex config.toml
~/.codex/config.toml
[mcp_servers.file-ai] command = "npx" args = ["-y", "@flyfish-dev/file-ai"]
Instalar File AI MCP en Gemini CLI
$ gemini mcp add -s user file-ai npx -- -y @flyfish-dev/file-aiInstalar File AI MCP en Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"file-ai": {
"command": "npx",
"args": [
"-y",
"@flyfish-dev/file-ai"
]
}
}
}Herramientas de File AI MCP 5
Detectado desde el READMEdoc_analyzedoc_readdoc_searchdoc_contextdoc_list_formats
| doc_analyze | — | |
| doc_read | — | |
| doc_search | — | |
| doc_context | — | |
| doc_list_formats | — |
Verificaciones automáticas
Ejecutado 14 nov 2026Informe completo →Pasó nuestras verificaciones automáticas. Esto no es una auditoría de seguridad: lee el código y dale al servidor el acceso más limitado que necesite. Cómo funcionan las verificaciones
- Repositorio de origen vinculado y accesibleflyfish-dev/file-ai is public and reachablegithub.com/flyfish-dev/file-ai ↗Aprobado
- El paquete indica este repositorio como su origen@flyfish-dev/file-ai names flyfish-dev/file-ai as sourcenpmjs.com/package/@flyfish-dev/file-ai ↗Aprobado
- Procedencia de la compilación (atestación de Sigstore)No build attestation published for this releaseNo verificado
- Licencia de código abierto (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Aprobado
- Commit o lanzamiento en el último añoLast commit or release 2026-06-24github.com/flyfish-dev/file-ai ↗Aprobado
- OpenSSF ScorecardNo verificado
- El nombre del paquete no es similar a un paquete popularNo popular package one edit away from @flyfish-dev/file-aiAprobado
- No hay avisos críticos en el paquete ni en sus dependencias154 resolved dependencies checked; no critical advisoryosv.dev ↗Aprobado
- Sin instrucciones ocultas para el modelo5 tool descriptions and the README read; no override phrases, credential paths or hidden charactersAprobado
- Las herramientas destructivas están etiquetadasNo tool named like delete, drop or execAprobado
- El endpoint remoto responde al handshake de MCPNo verificado
README
Ver en GitHubFile 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.
Preguntas sobre File AI MCP
¿Cómo agrego File AI MCP a Claude Code?
Ejecuta claude mcp add file-ai -- npx -y @flyfish-dev/file-ai en tu terminal. Añade --scope user para que esté disponible en todos los proyectos.
¿Cómo agrego File AI MCP a Cursor?
Abre ~/.cursor/mcp.json y añade el servidor en mcpServers, usando la configuración de Cursor que se muestra en la sección de instalación de arriba.
¿Qué herramientas proporciona File AI MCP?
Expone 5 herramientas, incluidas doc_analyze, doc_read, doc_search, doc_context, doc_list_formats.
¿File AI modifica mis archivos locales?
No, el servidor es de solo lectura y no muta tus documentos originales.
¿Qué tipos de formatos de archivo son compatibles?
Soporta más de 206 extensiones, incluyendo texto, código, Markdown, JSON, PDF, DOCX, XLSX/CSV, PPTX, EML y manifiestos de archivos comprimidos.