MCP File Tool

🚀 MCP ファイルサーバ

Model Context Protocol (MCP) をベースにしたサーバ実装で、標準化されたインターフェースを通じてファイルシステム操作を提供します。

🚀 クイックスタート

MCP ファイルサーバは、AI モデルが標準化された API を通じてローカルファイルシステムに対してファイル操作を実行できるようにします。これは Model Context Protocol SDK を使用して構築されており、ファイルの読み取り、作成、および一覧表示のツールを提供します。

✨ 主な機能

• ファイルの作成：指定されたパスに新しいファイルを作成し、内容を書き込むことができます。
• ファイルの読み取り：既存のファイルの内容を読み取ることができます。
• ディレクトリ内容の一覧表示：指定されたパス下のファイルとディレクトリ、およびその詳細情報を一覧表示できます。
• 性能監視：エラートラッキングと性能監視のために、Sentry 統合が組み込まれています。

📦 インストール

npm install

💻 使用例

基本的な使用法

MCP ファイルサーバを起動するには、以下のコマンドを実行します。

node src/index.js

サーバは stdin/stdout を通じて MCP プロトコルを使用して通信します。

利用可能なツール

createfile

指定されたパスに新しいファイルを作成し、内容を書き込みます。 パラメータ:

• filePath：ファイルを作成するパス
• content：ファイルに書き込む内容

戻り値:

• 成功メッセージで、ファイルパスとサイズ情報が含まれます。

readfile

指定されたパスのファイルの内容を読み取ります。 パラメータ:

• filePath：読み取るファイルのパス

戻り値:

• ファイルの内容

listfiles

指定されたパス下のファイルとディレクトリを一覧表示します。 パラメータ:

• path：内容を一覧表示するディレクトリのパス

戻り値:

• ファイル名、サイズ、およびタイプを含む Markdown テーブル

環境変数

• SENTRY_DSN：エラートラッキング用の Sentry データソース名（オプション）

依存関係

• @modelcontextprotocol/sdk：MCP SDK パッケージ
• zod：スキーマ検証
• @sentry/node：エラートラッキングと性能監視

高度な使用法

MCP プロトコルを通じてこれらのツールを呼び出す例を以下に示します。

{
  "name": "createfile",
  "params": {
    "filePath": "example/test.txt",
    "content": "Hello, world!"
  }
}

{
  "name": "readfile",
  "params": {
    "filePath": "example/test.txt"
  }
}

{
  "name": "listfiles",
  "params": {
    "path": "example"
  }
}