# File Time Search MCP Server

An MCP server that provides file searching capabilities based on modification or creation time.

## Features

- Search files by `modified` or `created` time.
- Filter by time range (`from`, `to`).
- Glob pattern matching.
- Pagination support.
- Secure root path restriction (`ALLOW_ROOTS`).

## Installation

```bash
npm install
```

## Usage with npx

You can run this server directly using npx:

```bash
export ALLOW_ROOTS=/path/to/search
npx file-search-mcp
```

## Usage

### Environment Variables

- `ALLOW_ROOTS`: Comma-separated list of allowed root directories (Required).
- `DEFAULT_ROOT`: Default root directory if not specified in request (Optional).

### Running via Stdio

```bash
export ALLOW_ROOTS=/path/to/search
npm run start:stdio
```

### Development

```bash
# Run in dev mode (stdio)
export ALLOW_ROOTS=$(pwd)
npm run dev:stdio

# Run tests
npm test
```

## Documentation

See [docs/README.md](docs/README.md) for detailed documentation.

## AI Agent Configuration (Claude Desktop)

To use this tool with Claude Desktop, you need to configure the `claude_desktop_config.json` file.

### 1. Build the Project

First, ensure the project is built:

```bash
npm run build
```

### 2. Edit Configuration

Open or create the configuration file:

- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`

Add the following configuration (replace paths with your actual paths):

```json
{
  "mcpServers": {
    "file-search": {
      "command": "node",
      "args": [
        "D:/1.playground_ai/file_search_mcp/dist/stdio.js"
      ],
      "env": {
        "ALLOW_ROOTS": "D:/1.playground_ai/file_search_mcp",
        "DEFAULT_ROOT": "D:/1.playground_ai/file_search_mcp"
      }
    }
  }
}
```

> **Note**: `ALLOW_ROOTS` is required. It defines the directories the AI is allowed to search. You can specify multiple paths separated by commas (or semicolons on Windows).

### 3. Usage Examples

Once configured and Claude Desktop is restarted, you can ask questions like:

- "Find all markdown files modified in the last 24 hours."
- "Search for files created between 2024-01-01 and 2024-02-01 in the src folder."
- "List the top 10 most recently modified files."

## VS Code Copilot Configuration

To use this tool with GitHub Copilot in VS Code, add the following to your VS Code `settings.json`:

### 1. Build the Project

Ensure the project is built:

```bash
npm run build
```

### 2. Edit VS Code Settings

Open your VS Code `settings.json` and add the `github.copilot.mcpServers` configuration:

```json
{
  "github.copilot.mcpServers": {
    "file-search": {
      "command": "node",
      "args": [
        "D:/1.playground_ai/file_search_mcp/dist/stdio.js"
      ],
      "env": {
        "ALLOW_ROOTS": "D:/1.playground_ai/file_search_mcp",
        "DEFAULT_ROOT": "D:/1.playground_ai/file_search_mcp"
      }
    }
  }
}
```

> **Note**: Replace the paths with your actual absolute paths. `ALLOW_ROOTS` is required.
>
> **Tip**: In VS Code, you can use `${workspaceFolder}` to dynamically set the current workspace path:
> ```json
> "env": {
>   "ALLOW_ROOTS": "${workspaceFolder}",
>   "DEFAULT_ROOT": "${workspaceFolder}"
> }
> ```