Skip to main content
Glama
deenesjakoruzh
jibixn

MCP File System Agent

by jibixn
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

MCP ファイルシステムエージェント

LangChain、Ollama、FastMCP、MCP を使用して構築されたローカル エージェント型ファイルシステムアシスタント。

このプロジェクトは、LLM が MCP サーバーによって公開されたツールを自律的に選択・使用し、ファイルの読み取り、一覧表示、書き込み、検索などの操作を実行する方法を示しています。

アーキテクチャ

                         User
                           │
                           ▼
                  ┌─────────────────┐
                  │  LangChain      │
                  │     Agent       │
                  └────────┬────────┘
                           │
                           ▼
                  ┌─────────────────┐
                  │   Ollama LLM    │
                  │   Qwen3 1.7B    │
                  └────────┬────────┘
                           │
                    Tool selection
                           │
                           ▼
                ┌──────────────────────┐
                │ LangChain MCP Adapter│
                └──────────┬───────────┘
                           │
                       MCP / HTTP
                           │
                           ▼
                ┌──────────────────────┐
                │     FastMCP Server   │
                │   localhost:8000/mcp │
                └──────────┬───────────┘
                           │
             ┌─────────────┼─────────────┐
             ▼             ▼             ▼
        read_file     list_files    write_file
             │
             ▼
       Local File System

Related MCP server: local-mcp

機能

  • MCP ベースのツールアーキテクチャ

  • HTTP トランスポートを使用したローカル FastMCP サーバー

  • ツール呼び出しを備えた LangChain エージェント

  • Ollama によるローカル LLM 推論

  • PDF ファイルの読み取り

  • DOCX ファイルの読み取りと書き込み

  • 拡張子フィルタリングによるファイル一覧表示

  • PDF および DOCX ファイル内の検索

  • LangGraph チェックポイントによる会話状態管理

  • LLM によるツールの自動選択

技術スタック

  • Python

  • LangChain

  • LangGraph

  • Ollama

  • Qwen3 1.7B

  • FastMCP

  • Model Context Protocol (MCP)

  • langchain-mcp-adapters

  • PyPDF

  • python-docx

プロジェクト構造

MCP/
│
├── tests/
│   └── sample.docx
│
├── fs_mcp.py
├── main.py
├── requirements.txt
└── README.md

インストール

1. リポジトリのクローン

git clone https://github.com/jibixn/File-System-Tools-MCP
cd MCP

2. Python 依存関係のインストール

pip install -r requirements.txt

3. Ollama のインストール

公式サイトから Ollama をインストールし、ローカルで実行されていることを確認してください。

次にモデルをプルします:

ollama pull qwen3:1.7b

モデルが利用可能かどうかは次のコマンドで確認できます:

ollama list

プロジェクトの実行

このプロジェクトは、MCP サーバーが HTTP 経由でクライアントと通信するため、2 つのプロセスを使用します。

ターミナル 1 — MCP サーバーの起動

プロジェクトルートから次のコマンドを実行します:

python fs_mcp.py

サーバーは次の場所で利用可能になるはずです:

http://127.0.0.1:8000/mcp

ターミナル 2 — エージェントの起動

プロジェクトルートで別のターミナルを開きます:

python main.py

その後、次のようなリクエストを入力できます:

Read the file in tests folder named sample.docx and provide me the summary.

または:

List all PDF files in the tests folder.

または:

Write "Hello, World!" to tests/output.docx.

エージェントフローの例

次のようなリクエストに対して:

Read the file in tests folder named sample.docx and provide me the summary.

エージェントは次の手順を実行します:

User request
     │
     ▼
LLM analyzes request
     │
     ▼
LLM selects read_file
     │
     ▼
LangChain MCP Adapter
     │
     ▼
MCP HTTP request
     │
     ▼
FastMCP read_file()
     │
     ▼
python-docx reads file
     │
     ▼
Tool result returned to agent
     │
     ▼
LLM summarizes content
     │
     ▼
Final response

要件

Python 3.11 以上を推奨します。

Ollama がインストールされ、ローカルで実行されている必要があります。

Qwen モデルが利用可能である必要があります:

ollama pull qwen3:1.7b

推論プロバイダーを通じてモデルを使用することもできます。

依存関係

このプロジェクトの直接の依存関係は次のとおりです:

fastmcp==3.4.7
langchain==1.3.14
langchain-mcp-adapters==0.3.2
langchain-ollama==1.1.0
langgraph-checkpoint==4.2.0
pypdf==6.14.2
python-docx==1.2.0

今後の改善点

  • より多くのファイル形式のサポート追加

  • ファイル削除およびディレクトリ作成ツールの追加

  • より強力なパス検証とサンドボックス化

  • リモート MCP サーバー向けの認証追加

  • ストリーミング応答の追加

  • よりリッチなドキュメント解析の追加

  • 永続的な会話状態の追加

  • データベース、GitHub、Web 検索向けの追加 MCP サーバー

  • より大きなローカルモデルによるツール選択の信頼性向上

学習目標

このプロジェクトは、以下の間の相互作用を示しています:

LLM
 ↓
LangChain Agent
 ↓
Tool Calling
 ↓
MCP Client
 ↓
MCP Protocol
 ↓
FastMCP Server
 ↓
Python Functions

これは、Model Context Protocol (MCP) とローカルでホストされた LLM を使用した エージェント型アプリケーション を構築するための実践的な例として意図されています。

This server cannot be installed

F
license - not found
-
quality - not tested
C
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • local-mcp

    fan-67
    A
    license
    -
    quality
    B
    maintenance
    A lightweight, stdio-based MCP server enabling AI assistants to perform local file system operations like reading, writing, searching, and executing commands.
    5,309
    MIT

  • mcp-coding

    cdemeo92
    A
    license
    -
    quality
    C
    maintenance
    Experimental MCP server for local LLM orchestration with filesystem tools (read, write, list, delete files) and a CLI agent that communicates via Ollama.
    9
    ISC

View all related MCP servers

Related MCP Connectors

  • saagarpatel.dev Portfolio

    Agent-native MCP server over the public saagarpatel.dev corpus. Read-only, stateless.

  • Frenchie

    OCR, transcription, file extraction, and image generation for AI agents via MCP.

  • hithereiamaliff-mcp-nextcloud

    A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/jibixn/File-System-Tools-MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server