Skip to main content
Glama
QuantGeekDev

Filesystem MCP Server

by QuantGeekDev

sistema de archivos

Un servidor de Protocolo de Contexto de Modelo (MCP) creado con mcp-framework.

Inicio rápido

# Install dependencies
npm install

# Build the project
npm run build

Related MCP server: MCP Tools

Estructura del proyecto

filesystem/
├── src/
│   ├── tools/        # MCP Tools
│   │   └── ExampleTool.ts
│   └── index.ts      # Server entry point
├── package.json
└── tsconfig.json

Agregar componentes

El proyecto incluye una herramienta de ejemplo en src/tools/ExampleTool.ts . Puedes agregar más herramientas mediante la CLI:

# Add a new tool
mcp add tool my-tool

# Example tools you might create:
mcp add tool data-processor
mcp add tool api-client
mcp add tool file-handler

Desarrollo de herramientas

Ejemplo de estructura de herramienta:

import { MCPTool } from "mcp-framework";
import { z } from "zod";

interface MyToolInput {
  message: string;
}

class MyTool extends MCPTool<MyToolInput> {
  name = "my_tool";
  description = "Describes what your tool does";

  schema = {
    message: {
      type: z.string(),
      description: "Description of this input parameter",
    },
  };

  async execute(input: MyToolInput) {
    // Your tool logic here
    return `Processed: ${input.message}`;
  }
}

export default MyTool;

Publicación en npm

  1. Actualice su paquete.json:

    • Asegúrese de que name sea único y siga las convenciones de nomenclatura de npm

    • Establecer version apropiada

    • Añadir description , author , license , etc.

    • Verificar los puntos bin en el archivo de entrada correcto

  2. Construir y probar localmente:

    npm run build
    npm link
    filesystem  # Test your CLI locally
  3. Inicie sesión en npm (cree una cuenta si es necesario):

    npm login
  4. Publica tu paquete:

    npm publish

Después de publicar, los usuarios pueden agregarlo a su cliente de escritorio Claude (leer a continuación) o ejecutarlo con npx


## Using with Claude Desktop

### Local Development

Add this configuration to your Claude Desktop config file:

**MacOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%/Claude/claude_desktop_config.json`

```json
{
  "mcpServers": {
    "filesystem": {
      "command": "node",
      "args":["/absolute/path/to/filesystem/dist/index.js"]
    }
  }
}

Después de la publicación

Agregue esta configuración a su archivo de configuración de Claude Desktop:

MacOS : ~/Library/Application Support/Claude/claude_desktop_config.json Windows : %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["filesystem"]
    }
  }
}

Construcción y pruebas

  1. Realizar cambios en sus herramientas

  2. Ejecute npm run build para compilar

  3. El servidor cargará automáticamente sus herramientas al iniciarse

Más información

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    A Model Context Protocol server that enables AI assistants like Claude to perform Python development tasks through file operations, code analysis, project management, and safe code execution.
    9
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    A custom Model Context Protocol server that gives Claude Desktop and other LLMs access to file system operations and command execution capabilities through standardized tool interfaces.
    23
    Apache 2.0
  • A
    license
    Not graded
    quality
    D
    maintenance
    A Model Context Protocol (MCP) server that allows AI models to safely access and interact with local file systems, enabling reading file contents, listing directories, and retrieving file metadata.
    2 npm
    10
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    A Model Context Protocol server that enables Claude Desktop to perform file operations like reading, writing, listing directories, and managing files through natural language commands.
    MIT