Local Filesystem MCP Server

A Model Context Protocol (MCP) server for exploring local filesystems with glob and grep tools.

Built with Smithery SDK

Features

This server provides two essential tools for filesystem exploration:

• glob - Find files matching patterns (e.g., **/*.ts, src/**/*.js)

• grep - Search for text patterns in files

Prerequisites

• Smithery API key: Get yours at smithery.ai/account/api-keys

Getting Started

1. Install dependencies:

   npm install

2. Start development server:

   npm run dev

The server will run locally and provide access to your filesystem through the MCP protocol.

Configuration

You can customize the working directory in your smithery.yaml config:

runtime: typescript
target: local
config:
  workingDirectory: /path/to/your/directory

By default, it uses the current working directory.

Development

Your code is organized as:

• src/index.ts - MCP server with glob and grep tools

• smithery.yaml - Runtime specification with target: local for filesystem access

Edit src/index.ts to add your own filesystem tools.

Build

npm run build

Creates bundled server in .smithery/

Deploy

This server uses target: local in smithery.yaml, which means it's designed to run locally with filesystem access. It cannot be deployed to remote Smithery hosting.

Learn More

• Smithery Docs

• MCP Protocol