File AI MCPサーバー
✓ 検証済みローカルファイルを検索可能なプロファイル、アンカー、およびコンテキストスニペットに変換することで、AIエージェントに構造化されたドキュメント認識機能を提供します。
別名 flyfish-dev/file-ai, file-ai, @flyfish-dev/file-ai
- スター
- 3
- ツール
- 5
- ダウンロード数(30日間)
- 189
- 最新バージョン
- 0.1.1
- 最終コミット
- 2026年6月24日
- ライセンス
- Apache-2.0
File AI MCPとは
ローカルファイルを検索可能なプロファイル、アンカー、およびコンテキストスニペットに変換することで、AIエージェントに構造化されたドキュメント認識機能を提供します。 5個のツールを提供しており、doc_analyze, doc_read, doc_searchなどがあります。
プロジェクトのREADMEから生成された概要
File AI MCP server について
File AIは、ファイルを検索可能なプロファイル、アンカー、およびコンテキストスニペットに変換することで、AIエージェントにローカルドキュメントの構造化された認識機能を提供します。このサーバーは読み取り専用レイヤーとして機能するため、エージェントがPDF、OOXML、スプレッドシートなどの複雑なファイル内部構造を解析し直す必要がなくなります。開発者は、npxを使用してローカルでサーバーを実行するか、npm経由でグローバルにインストールしてstdioトランスポートを利用できます。また、指定したホストとポートでのstreamable HTTPトランスポートもサポートしています。
このサーバーは、Flyfish File Viewer coreを使用して、登録済みの206種類の拡張子にわたるフォーマット認識を行います。特定のツールとして、解析とインデックスのキャッシュを行うdoc_analyze、ブロックやチャンクにアクセスするdoc_read、ソースアンカーを用いてコンテンツを検索するdoc_searchを提供します。さらに、周辺テキストを取得するdoc_contextや、サポートされている拡張子とレンダラーの機能をチェックするdoc_list_formatsも含まれています。テキスト、コード、Markdown、JSON、PDF、DOCX、XLSX、CSV、PPTX、EMLの深い抽出が可能である一方、CADやメディアファイルなどの他の形式については、メタデータや警告を返すこともできます。
プロジェクトの 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を開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
File AI MCPが提供するツールは
5個のツールを提供しており、doc_analyze, doc_read, doc_search, doc_context, doc_list_formatsなどがあります。
File AIはローカルファイルを変更しますか?
いいえ、このサーバーは読み取り専用であり、ソースドキュメントを書き換えることはありません。
どのようなファイル形式がサポートされていますか?
テキスト、コード、Markdown、JSON、PDF、DOCX、XLSX/CSV、PPTX、EML、およびアーカイブのマニフェストを含む、206種類以上の拡張子をサポートしています。