Filesystem MCP

🚀 ファイルシステム MCP 🌐

このプロジェクトは、Node.js ベースのモデルコンテキストプロトコル（MCP）サーバーを提供し、AI エージェント（Cline や Claude など）に安全で相対的なファイルシステムアクセスを提供します。

🚀 クイックスタート

このセクションでは、ファイルシステム MCP サーバーの基本的な使い方を紹介します。

✨ 主な機能

• 安全なアクセス：AI エージェントが安全にファイルシステムとやり取りできるようにします。
• 相対パスのサポート：絶対パスを必要としないファイルアクセスを簡素化します。
• AI エージェントのサポート：Cline と Claude との連携に特化して設計されています。
• Node.js で構築：Node.js の強力な機能を利用して、効率的なサーバーサイド操作を実現します。
• TypeScript のサポート：型安全を提供し、開発者体験を向上させます。

📦 インストール

ファイルシステム MCP サーバーを使用するには、以下の手順に従ってください。

リポジトリのクローン

git clone https://github.com/Tabeeh/filesystem-mcp.git
cd filesystem-mcp

依存関係のインストール

Node.js がインストールされていることを確認し、次のコマンドを実行します。

npm install

最新バージョンのダウンロード

ここ から最新バージョンをダウンロードできます。該当するファイルをダウンロードして実行してください。

💻 使用例

基本的な使用法

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

npm start

設定例

config.json ファイルを編集することで、サーバーを設定できます。以下は設定例です。

{
  "port": 3000,
  "secure": true,
  "allowedAgents": ["Cline", "Claude"]
}

リクエストの送信

サーバーが起動したら、以下のコマンドを使用してファイルシステムにアクセスするリクエストを送信できます。

curl -X GET http://localhost:3000/files/path/to/your/file

エラー処理

サーバーは、さまざまなエラーに対して適切な HTTP ステータスコードを返します。例えば：

• 404 Not Found：リソースが見つかりません。
• 500 Internal Server Error：サーバー内部エラー。

📚 ドキュメント

ファイル内容の取得

URL: /files/:filename
メソッド: GET

レスポンス例

成功時：

{
  "content": "...",
  "status": "success"
}

失敗時：

{
  "message": "...",
  "status": "error"
}

新しいファイルの作成

URL: /files
メソッド: POST
リクエストボディ:
{
  "filename": "string",
  "content": "string"
}

🔧 貢献ガイド

このプロジェクトに貢献するには、以下の手順に従ってください。

1. リポジトリのフォーク：GitHub でこのリポジトリをフォークします。
2. 機能ブランチの作成：

git checkout -b feature/your-feature-name main

3. 変更のコミット：変更をコミットし、コミットメッセージの形式規則に従ってください。
4. リモートリポジトリへのプッシュ：

git push origin feature/your-feature-name

5. Pull Request の作成：GitHub であなたのブランチに対して Pull Request を作成します。

📄 ライセンス

このプロジェクトは MIT ライセンスの下で提供されています。詳細については、LICENSE ファイルを参照してください。

📬 連絡先

作者：[あなたの名前]
メール：[あなたのメールアドレス]
GitHub リポジトリ：https://github.com/Tabeeh/filesystem-mcp

ファイルシステム MCP をご利用いただき、ありがとうございます！ 最新の更新情報については、リリースページ をご確認ください。