Skip to main content
Glama
QuantGeekDev

Filesystem MCP Server

by QuantGeekDev

ファイルシステム

mcp-framework を使用して構築されたモデル コンテキスト プロトコル (MCP) サーバー。

クイックスタート

# Install dependencies
npm install

# Build the project
npm run build

Related MCP server: MCP Tools

プロジェクト構造

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

コンポーネントの追加

このプロジェクトにはsrc/tools/ExampleTool.tsにサンプルツールが付属しています。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

ツール開発

ツール構造の例:

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;

npmへの公開

  1. package.json を更新します。

    • nameが一意であり、npm の命名規則に従っていることを確認してください。

    • 適切なversionを設定する

    • description 、 author 、 licenseなどを追加します。

    • binが正しいエントリファイルを指しているか確認する

  2. ローカルでビルドしてテストします。

    npm run build
    npm link
    filesystem  # Test your CLI locally
  3. npm にログインします (必要に応じてアカウントを作成します)。

    npm login
  4. パッケージを公開します:

    npm publish

公開後、ユーザーはそれをクロードデスクトップクライアント(下記参照)に追加したり、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"]
    }
  }
}

公開後

この構成を Claude Desktop 構成ファイルに追加します。

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

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

構築とテスト

  1. ツールに変更を加える

  2. npm run buildを実行してコンパイルする

  3. サーバーは起動時にツールを自動的に読み込みます

もっと詳しく知る

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