Skip to main content
Glama
Sign In
FTP Doc Reader MCP Server

FTP Doc Reader MCP Server

by hackerpl
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

FTP Doc Reader MCP Server

中文文档

An MCP (Model Context Protocol) server that recursively searches .doc and .docx files in a specified directory on a remote FTP/FTPS server, matches document content by keyword, and returns relevant files with context snippets.

Features

  • Recursive directory scanning: Automatically scans all Word documents in FTP directories and subdirectories (max depth 10, max 200 files)

  • Content keyword matching: Case-insensitive full-text search, returns context snippets (100 characters before and after each match)

  • Supports .doc and .docx: Handles both legacy binary format and modern XML format

  • FTP/FTPS dual protocol: Supports plain FTP and TLS-encrypted FTPS

  • Local file caching: Size-based cache invalidation strategy to avoid redundant downloads

  • Auto retry: Transient network errors are automatically retried 3 times (2-second intervals)

  • Deploy via uvx: No manual dependency management required

Related MCP server: Word Document Reader MCP Server

Installation

Via uvx (Recommended)

uvx ftp-doc-reader

From source

git clone https://github.com/hackerpl/doc-mcp-server.git
cd doc-mcp-server
pip install -e .

MCP Configuration

Claude Desktop

Edit claude_desktop_config.json:

{
  "mcpServers": {
    "ftp-doc-reader": {
      "command": "uvx",
      "args": ["ftp-doc-reader"],
      "env": {
        "FTP_HOST": "ftp.example.com",
        "FTP_USERNAME": "your_username",
        "FTP_PASSWORD": "your_password",
        "FTP_PROTOCOL": "FTP",
        "FTP_PORT": "21",
        "CACHE_DIR": ".cache"
      }
    }
  }
}

Kiro

Edit .kiro/settings/mcp.json:

{
  "mcpServers": {
    "ftp-doc-reader": {
      "command": "uvx",
      "args": ["ftp-doc-reader"],
      "env": {
        "FTP_HOST": "ftp.example.com",
        "FTP_USERNAME": "your_username",
        "FTP_PASSWORD": "your_password"
      },
      "disabled": false,
      "autoApprove": ["search_docs"]
    }
  }
}

Cursor

Edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "ftp-doc-reader": {
      "command": "uvx",
      "args": ["ftp-doc-reader"],
      "env": {
        "FTP_HOST": "ftp.example.com",
        "FTP_USERNAME": "your_username",
        "FTP_PASSWORD": "your_password"
      }
    }
  }
}

From GitHub source (development)

{
  "mcpServers": {
    "ftp-doc-reader": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/hackerpl/doc-mcp-server.git", "ftp-doc-reader"],
      "env": {
        "FTP_HOST": "ftp.example.com",
        "FTP_USERNAME": "your_username",
        "FTP_PASSWORD": "your_password"
      }
    }
  }
}

Environment Variables

Variable

Required

Default

Description

FTP_HOST

✅

—

FTP server hostname or IP

FTP_USERNAME

✅

—

FTP login username

FTP_PASSWORD

✅

—

FTP login password

FTP_PORT

❌

21

FTP server port

FTP_PROTOCOL

❌

FTP

Connection protocol: FTP or FTPS

CACHE_DIR

❌

.cache

Local cache directory path

Environment variables can be set via the env field in MCP configuration, or by placing a .env file in the project directory.

MCP Tool

search_docs

Search Word document content in a remote FTP directory.

Parameters:

Parameter

Type

Description

query

string (1-500 chars)

Search keyword or phrase

directory_path

string (1-1024 chars)

Remote FTP directory path

Returns:

A list of matching results (sorted by match count descending), each containing:

  • file_path — Full remote path of the file

  • file_name — File name

  • snippets — List of matched context snippets (max 5 per file)

Usage example:

Search for documents containing "installation guide" in the /products/docs directory on the FTP server

The AI assistant will call:

{
  "tool": "search_docs",
  "arguments": {
    "query": "installation guide",
    "directory_path": "/products/docs"
  }
}

Development

# Install development dependencies
pip install -e ".[dev]"

# Run tests
pytest

# Run tests with coverage
pytest --cov

# Start server directly (requires .env file)
python -m ftp_doc_reader

Tech Stack

  • Python 3.10+

  • MCP Python SDK (FastMCP)

  • python-docx (.docx parsing)

  • olefile (.doc parsing)

  • python-dotenv (environment variable management)

License

MIT

Available Tools

1 tool
search_docsB

Search .doc/.docx files in a remote FTP directory for content matching the query.

Args: query: Search keyword or phrase for content matching (1-500 characters). directory_path: Remote FTP directory path to search in (1-1024 characters).

Returns: List of search results sorted by snippet count (descending), or an error message string on failure.

Inputs: query (required), directory_path (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    B3.4/5.0

    Scored across 1 tool

    Disambiguation5/5

    Only one tool exists, so there is no possibility of confusion between tools.

    Naming Consistency5/5

    With a single tool, naming consistency is trivially maintained.

    Tool Count2/5

    The server has only one tool, which feels insufficient for a 'Doc Reader' server—missing basic operations like listing or downloading documents.

    Completeness2/5

    The tool only supports searching; there are no tools for listing, reading, or managing documents, leaving significant gaps for document reading tasks.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers