File AI MCP server
✓ 인증됨로컬 파일을 검색 가능한 프로필, 앵커, 컨텍스트 스니펫으로 변환하여 AI agent에게 구조화된 문서 인지 능력을 제공합니다.
다른 이름 flyfish-dev/file-ai, file-ai, @flyfish-dev/file-ai
- 스타
- 3
- Tools
- 5
- 다운로드, 30일
- 189
- 최신 버전
- 0.1.1
- 마지막 커밋
- 2026년 6월 24일
- 라이선스
- Apache-2.0
File AI MCP란?
로컬 파일을 검색 가능한 프로필, 앵커, 컨텍스트 스니펫으로 변환하여 AI agent에게 구조화된 문서 인지 능력을 제공합니다. 5개 도구를 제공합니다. 예: doc_analyze, doc_read, doc_search.
프로젝트 README에서 생성된 요약
File AI MCP server 정보
File AI는 파일을 검색 가능한 프로필, 앵커, 컨텍스트 스니펫으로 변환하여 AI agent에게 로컬 문서에 대한 구조화된 인지 능력을 제공합니다. 이 server는 읽기 전용 레이어로 작동하여, agent가 PDF, OOXML 또는 스프레드시트와 같은 복잡한 파일 내부 구조를 직접 분석할 필요가 없도록 합니다. 개발자는 npx를 사용하여 로컬에서 server를 실행하거나 npm을 통해 전역으로 설치하여 stdio transport를 사용할 수 있습니다. 또한 지정된 host와 port에서 streamable HTTP transport를 지원합니다.
이 server는 206개의 등록된 확장자에 대해 형식 인식을 수행하기 위해 Flyfish File Viewer core를 사용합니다. 인덱스를 파싱하고 캐싱하는 doc_analyze, 블록 또는 청크에 접근하는 doc_read, 소스 앵커와 함께 콘텐츠를 찾는 doc_search와 같은 특정 도구를 제공합니다. 또한 주변 텍스트를 가져오는 doc_context와 지원되는 확장자 및 렌더러 기능을 확인하는 doc_list_formats도 포함되어 있습니다. text, code, Markdown, JSON, PDF, DOCX, XLSX, CSV, PPTX, EML에 대해 심층 추출을 제공하며, CAD 또는 미디어 파일과 같은 other 형식에 대해서는 메타데이터와 경고를 반환할 수 있습니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
File AI MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 File AI MCP 설치
$ claude mcp add file-ai -- npx -y @flyfish-dev/file-aiCursor에 File AI MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"file-ai": {
"command": "npx",
"args": [
"-y",
"@flyfish-dev/file-ai"
]
}
}
}VS Code에 File AI MCP 설치
.vscode/mcp.json
{
"servers": {
"file-ai": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@flyfish-dev/file-ai"
]
}
}
}VS Code CLI에 File AI MCP 설치
$ code --add-mcp '{"name":"file-ai","type":"stdio","command":"npx","args":["-y","@flyfish-dev/file-ai"]}'Claude Desktop에 File AI MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"file-ai": {
"command": "npx",
"args": [
"-y",
"@flyfish-dev/file-ai"
]
}
}
}Codex에 File AI MCP 설치
$ codex mcp add file-ai -- npx -y @flyfish-dev/file-aiCodex config.toml에 File AI MCP 설치
~/.codex/config.toml
[mcp_servers.file-ai] command = "npx" args = ["-y", "@flyfish-dev/file-ai"]
Gemini CLI에 File AI MCP 설치
$ gemini mcp add -s user file-ai npx -- -y @flyfish-dev/file-aiGemini settings.json에 File AI MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"file-ai": {
"command": "npx",
"args": [
"-y",
"@flyfish-dev/file-ai"
]
}
}
}File AI MCP 도구 5
README에서 감지됨doc_analyzedoc_readdoc_searchdoc_contextdoc_list_formats
| doc_analyze | — | |
| doc_read | — | |
| doc_search | — | |
| doc_context | — | |
| doc_list_formats | — |
자동 검사
2026년 11월 14일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능flyfish-dev/file-ai is public and reachablegithub.com/flyfish-dev/file-ai ↗통과
- 패키지가 이 저장소를 소스로 명시@flyfish-dev/file-ai names flyfish-dev/file-ai as sourcenpmjs.com/package/@flyfish-dev/file-ai ↗통과
- 빌드 출처(Sigstore 증명)No build attestation published for this release검사되지 않음
- 오픈 소스 라이선스 (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-06-24github.com/flyfish-dev/file-ai ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from @flyfish-dev/file-ai통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음154 resolved dependencies checked; no critical advisoryosv.dev ↗통과
- 모델에 대한 숨겨진 지침 없음5 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨No tool named like delete, drop or exec통과
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기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 질문
File AI MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add file-ai -- npx -y @flyfish-dev/file-ai를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
File AI MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
File AI MCP는 어떤 도구를 제공하나요?
5개 도구를 제공합니다. 예: doc_analyze, doc_read, doc_search, doc_context, doc_list_formats.
File AI가 로컬 파일을 수정하나요?
아니요, 이 server는 읽기 전용이며 소스 문서를 변경하지 않습니다.
어떤 파일 형식을 지원하나요?
text, code, Markdown, JSON, PDF, DOCX, XLSX/CSV, PPTX, EML 및 아카이브 매니페스트를 포함하여 206개 이상의 확장자를 지원합니다.