File AI MCP sunucusu
✓ DoğrulandıYerel dosyaları aranabilir profillere, çapalara (anchors) ve bağlamsal parçacıklara dönüştürerek yapay zeka ajanlarına yapılandırılmış belge farkındalığı sağlar.
Ayrıca bilinen adı flyfish-dev/file-ai, file-ai, @flyfish-dev/file-ai
- Yıldızlar
- 3
- Araçlar
- 5
- İndirmeler, 30 gün
- 189
- En son sürüm
- 0.1.1
- Son commit
- 24 Haz 2026
- Lisans
- Apache-2.0
File AI MCP nedir?
Yerel dosyaları aranabilir profillere, çapalara (anchors) ve bağlamsal parçacıklara dönüştürerek yapay zeka ajanlarına yapılandırılmış belge farkındalığı sağlar. 5 araç sunar; örneğin doc_analyze, doc_read, doc_search.
Özet, projenin README dosyasından oluşturuldu
File AI MCP sunucusu hakkında
File AI, dosyaları aranabilir profillere, çapalara ve bağlamsal parçacıklara dönüştürerek yapay zeka ajanlarına yerel belgeler üzerinde yapılandırılmış bir farkındalık kazandırır. Ajanların PDF, OOXML veya e-tablo gibi karmaşık dosya iç yapılarını tersine mühendislik ile çözmesine gerek kalmamasını sağlayan salt okunur bir katman olarak çalışır. Geliştiriciler, stdio transport protokolünü kullanmak için sunucuyu npx ile yerel olarak çalıştırabilir veya npm üzerinden global olarak yükleyebilirler. Ayrıca, belirtilen bir host ve port üzerinde streamable HTTP transport desteği de sunar.
Sunucu, kayıtlı 206 uzantı genelinde format tanıma işlemi için Flyfish File Viewer çekirdeğini kullanır. Ayrıştırma ve indeks önbelleğe alma için doc_analyze, bloklara veya parçalara erişmek için doc_read ve kaynak çapa noktalarıyla içerik bulmak için doc_search gibi özel araçlar sunar. Ayrıca, çevreleyen metni geri getirmek için doc_context ve desteklenen uzantıları ile render yeteneklerini kontrol etmek için doc_list_formats araçlarını içerir. Metin, kod, Markdown, JSON, PDF, DOCX, XLSX, CSV, PPTX ve EML için derinlemesine veri çıkarma sağlarken; CAD veya medya dosyaları gibi diğer formatlar için meta veri ve uyarılar da döndürebilir.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
File AI MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleFile AI MCP'yi Claude Code içine yükleyin
$ claude mcp add file-ai -- npx -y @flyfish-dev/file-aiFile AI MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"file-ai": {
"command": "npx",
"args": [
"-y",
"@flyfish-dev/file-ai"
]
}
}
}File AI MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"file-ai": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@flyfish-dev/file-ai"
]
}
}
}File AI MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"file-ai","type":"stdio","command":"npx","args":["-y","@flyfish-dev/file-ai"]}'File AI MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"file-ai": {
"command": "npx",
"args": [
"-y",
"@flyfish-dev/file-ai"
]
}
}
}File AI MCP'yi Codex içine yükleyin
$ codex mcp add file-ai -- npx -y @flyfish-dev/file-aiFile AI MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.file-ai] command = "npx" args = ["-y", "@flyfish-dev/file-ai"]
File AI MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user file-ai npx -- -y @flyfish-dev/file-aiFile AI MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"file-ai": {
"command": "npx",
"args": [
"-y",
"@flyfish-dev/file-ai"
]
}
}
}File AI MCP araçları 5
README dosyasından algılandıdoc_analyzedoc_readdoc_searchdoc_contextdoc_list_formats
| doc_analyze | — | |
| doc_read | — | |
| doc_search | — | |
| doc_context | — | |
| doc_list_formats | — |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirflyfish-dev/file-ai is public and reachablegithub.com/flyfish-dev/file-ai ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyor@flyfish-dev/file-ai names flyfish-dev/file-ai as sourcenpmjs.com/package/@flyfish-dev/file-ai ↗Geçti
- Derleme kökeni (Sigstore onayı)No build attestation published for this releaseKontrol edilmedi
- Açık kaynak lisansı (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-06-24github.com/flyfish-dev/file-ai ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from @flyfish-dev/file-aiGeçti
- Pakette veya bağımlılıklarında kritik uyarı yok154 resolved dependencies checked; no critical advisoryosv.dev ↗Geçti
- Modele yönelik gizli talimat yok5 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişNo tool named like delete, drop or execGeçti
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
File 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 soruları
File AI MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add file-ai -- npx -y @flyfish-dev/file-ai komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
File AI MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
File AI MCP hangi araçları sunar?
5 araç sunar; bunlar arasında doc_analyze, doc_read, doc_search, doc_context, doc_list_formats yer alır.
File AI yerel dosyalarımı değiştirir mi?
Hayır, sunucu salt okunur (read-only) moddadır ve kaynak belgelerinizi değiştirmez.
Hangi dosya formatları destekleniyor?
Metin, kod, Markdown, JSON, PDF, DOCX, XLSX/CSV, PPTX, EML ve arşiv manifestoları dahil olmak üzere 206'dan fazla uzantıyı destekler.