mcp-filesystem-python
MCP Filesystem Pythonは、指定されたディレクトリ内のファイルに安全な読み取り専用アクセスを提供するMCPサーバーです。ファイルをMCPリソースとして公開し、検索機能や.gitignoreパターンの尊重、パス横断防止などのセキュリティ機能を備えています。MIMEタイプの検出も行います。
GitHubスター
19
ユーザー評価
未評価
フォーク
5
イシュー
0
閲覧数
1
お気に入り
0
README
MCP Filesystem Python
A Model Context Protocol (MCP) server that provides secure, read-only access to files in a specified directory.
Features
- Exposes files as MCP resources using `file://` URI scheme
- Provides file search capabilities through MCP tools
- Respects .gitignore patterns
- Security features including path traversal protection
- MIME type detection
Installation
Using UV:
uv add mcp-filesystem-python
Usage
Run the server:
uv run src/filesystem/server.py /path/to/directory
Claude Desktop Integration
Configuration Examples
Example configurations for Claude Desktop can be found in the `examples` directory:
- `examples/claude_desktop_config.json`: Example for macOS/Linux
- `examples/claude_desktop_config_windows.json`: Example for Windows
These files should be placed at:
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%AppData%\Claude\claude_desktop_config.json`
Make sure to:
- Replace the paths with your actual paths
- Use forward slashes (`/`) for macOS/Linux and backslashes (`\\`) for Windows
- Use absolute paths (not relative paths)
Development
- Clone the repository
- Create virtual environment and sync requirements,
uv sync