{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_fge3yzcvtqyr","handle":"mcp-file-reader","url":"https://wellknown.network/agents/mcp-file-reader","links":{"self":"https://wellknown.network/agents/mcp-file-reader/record.json","html":"https://wellknown.network/agents/mcp-file-reader","markdown":"https://wellknown.network/agents/mcp-file-reader/record.md","api":"https://wellknown.network/api/v1/agents/mcp-file-reader","status":"https://wellknown.network/api/v1/agents/mcp-file-reader/status","claim":"https://wellknown.network/agents/mcp-file-reader/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mcp-file-reader/claim.json","badge":"https://wellknown.network/agents/mcp-file-reader/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mcp-file-reader/history","tools":"https://wellknown.network/api/v1/agents/mcp-file-reader/tools"},"ard":{"identifier":"urn:air::server:mcp-file-reader","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mcp-file-reader","summary":"A Model Context Protocol (MCP) service that extracts text content from files using Apache Tika","description":"# MCP File Reader\n\nA Model Context Protocol (MCP) service that extracts text content from files using Apache Tika. This service provides a single tool that can read various file formats (PDF, Word, Excel, PowerPoint, images with OCR, and more) and return their text content.\n\n## Features\n\n- **File Content Extraction**: Reads files and extracts text using Apache Tika\n- **Multiple Format Support**: Supports PDF, DOCX, XLSX, PPTX, images, and many other formats\n- **Automatic Tika Management**: Automatically starts and manages Tika server when needed\n- **Simple Deployment**: Easy installation and setup using uv\n- **Directory Access Control**: Configurable allowed directories for secure file access\n- **Path Traversal Protection**: Prevents access outside allowed directories via path traversal attacks\n- **Environment Configuration**: Configurable Tika server endpoint and allowed directories\n- **Error Handling**: Comprehensive error handling for missing files, network issues, etc.\n\n## Installation and usage\n\nSince this package is designed to be used as an MCP service, it is typically installed by\ninserting an entry into the configuration of your MCP client. The examples below are for\nthe `claude_desktop_confoig.json` settings for the Claude Desktop app, but the general content\nof the settings should be the same for other applications.\n\n### Using uvx (Recommended)\n\nInsert the `\"file-reader\"` stanza below into your `mcpServers` configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"file-reader\": {\n      \"command\": \"uvx\",\n      \"args\": [\n        \"mcp-file-reader\",\n        \"/Users/your_name/Desktop\",\n        \"/Users/your_name/Downloads\",\n        \"/Users/your_name/other_accessible_directory\"\n      ]\n    }\n  }\n}\n```\n\n### Running from a local development copy\n\nCheck out the latest source using:\n```bash\ncd /Users/your_name/source_path\ngit clone https://github.com/nickovs/mcp_file_reader.git\n```\n\nThen insert the `\"file-reader\"` stanza below into your `mcpServers` configuration:\n\n```json\n…","publisher":{"name":"Nicko van Someren","url":null},"homepage":"https://github.com/nickovs/mcp_file_reader","repository":"https://github.com/nickovs/mcp_file_reader","version":"0.2.2","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:mcp-file-reader","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":1,"provenance":"derived"},{"slug":"documents.presentations","name":"Presentations","confidence":0.802,"provenance":"derived"},{"slug":"dev.filesystem","name":"Filesystem","confidence":0.802,"provenance":"derived"},{"slug":"dev.ci-cd","name":"CI/CD & Deploy","confidence":0.779,"provenance":"derived"},{"slug":"documents.spreadsheets","name":"Spreadsheets","confidence":0.745,"provenance":"derived"}],"categories":["dev","documents"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mcp-file-reader","registry":"pypi","observedAt":"2026-10-22T09:23:17.495Z","publishedAt":"2025-05-28T22:49:35.958238Z","latestVersion":"0.2.2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mcp-file-reader","url":"https://pypi.org/project/mcp-file-reader/","firstSeenAt":"2026-09-10T01:20:48.320Z","fetchedAt":"2026-10-22T09:21:20.314Z","normalizedAt":"2026-10-22T09:21:20.314Z"}]},"firstSeenAt":"2026-09-10T01:20:48.320Z","updatedAt":"2026-10-22T09:23:17.495Z"}