tsuki_mcp_filesystem_server Máy chủ MCP

“tsuki_mcp_filesystem_server” Máy chủ MCP làm gì?

tsuki_mcp_filesystem_server là một máy chủ tùy chỉnh tương thích với Model Context Protocol (MCP), được thiết kế để hỗ trợ tìm kiếm và mở tệp trên hệ thống tệp cục bộ. Được tối ưu cho tích hợp với OpenAI’s Agent SDK, nó phơi bày các tài nguyên hệ thống tệp thông qua MCP, cho phép các trợ lý và tác nhân AI truy vấn, liệt kê và truy cập các tệp trong một thư mục chỉ định trên máy chủ. Các tính năng chính bao gồm tự động phát hiện loại MIME và cấu hình linh hoạt qua biến môi trường. Bằng cách hỗ trợ phương thức resources/list, máy chủ này cho phép các quy trình phát triển cần phát hiện hoặc quản lý tệp tự động, giúp các công cụ AI tương tác với tệp cục bộ theo cách tiêu chuẩn và an toàn.

Danh sách Prompt

Không có mẫu prompt nào được đề cập trong kho mã nguồn.

Danh sách Tài nguyên

• Tài nguyên Hệ thống tệp
  Cung cấp quyền truy cập các tệp hệ thống cục bộ, cho phép khách hàng tìm kiếm và liệt kê tệp trong một thư mục chỉ định.
• resources/list
  Một endpoint cho phép lấy danh sách tệp trong thư mục đích, phơi bày chúng như tài nguyên cho khách hàng AI.

Danh sách Công cụ

• resources/list
  Công cụ cho phép liệt kê các tệp trong thư mục cục bộ đã cấu hình, giúp khách hàng có thể sử dụng tiếp theo.

Trường hợp sử dụng của Máy chủ MCP này

• Phát hiện tệp cục bộ
  Lập trình viên có thể dùng máy chủ để tự động phát hiện và liệt kê tệp trong một thư mục mục tiêu, hỗ trợ các tác vụ quản lý tệp.
• Ngữ cảnh tệp cho LLM
  Cho phép mô hình ngôn ngữ lớn và tác nhân AI lấy danh sách tệp cục bộ, sử dụng làm ngữ cảnh cho phân tích mã nguồn hoặc tài liệu.
• Tích hợp Agent SDK
  Hoạt động mượt mà với OpenAI’s Agent SDK, cho phép tác nhân sử dụng khả năng tìm kiếm tệp như một phần của luồng tự động hóa rộng hơn.
• Tự động phát hiện loại MIME
  Tự động nhận diện loại MIME cho tệp, hữu ích khi xử lý hoặc lọc tệp theo loại.

Cách thiết lập

Windsurf

1. Yêu cầu:
   Đảm bảo đã cài đặt Python và pip.
2. Sao chép kho mã nguồn:
   git clone https://github.com/yuutotsuki/tsuki_mcp_filesystem_server.git
3. Cài đặt các phụ thuộc:
   pip install -r requirements.txt
4. Cấu hình môi trường:
   Sao chép .env.example thành .env và chỉnh sửa ROOT_PATH, HOST, PORT, và LOG_LEVEL.
5. Đăng ký với Windsurf:
   Thêm thông tin máy chủ vào cấu hình MCP của Windsurf.

Ví dụ JSON:

{
  "mcpServers": {
    "tsuki_mcp_filesystem": {
      "command": "python",
      "args": ["main.py"]
    }
  }
}

Bảo mật API Key:

{
  "env": {
    "ROOT_PATH": "/path/to/your/search/directory"
  },
  "inputs": {}
}

Claude

1. Yêu cầu:
   Cài đặt Python và các phụ thuộc như trên.
2. Thiết lập môi trường:
   Cấu hình .env với thư mục của bạn.
3. Tích hợp với Claude:
   Thêm cấu hình MCP server vào thiết lập Claude.
4. Khởi động máy chủ:
   python main.py
5. Kiểm tra kết nối:
   Đảm bảo Claude nhận diện được MCP server.

Ví dụ JSON:

{
  "mcpServers": {
    "tsuki_mcp_filesystem": {
      "command": "python",
      "args": ["main.py"]
    }
  }
}

Bảo mật API Key:

{
  "env": {
    "ROOT_PATH": "/path/to/your/search/directory"
  },
  "inputs": {}
}

Cursor

1. Sao chép và cài đặt:
   Sao chép kho mã nguồn và cài đặt các phụ thuộc.
2. Thiết lập môi trường:
   Sao chép và chỉnh sửa .env.
3. Cấu hình Cursor:
   Thêm MCP server vào cấu hình Cursor.
4. Chạy máy chủ:
   python main.py
5. Khởi động lại Cursor và kiểm tra:
   Đảm bảo MCP được nhận diện.

Ví dụ JSON:

{
  "mcpServers": {
    "tsuki_mcp_filesystem": {
      "command": "python",
      "args": ["main.py"]
    }
  }
}

Bảo mật API Key:

{
  "env": {
    "ROOT_PATH": "/path/to/your/search/directory"
  },
  "inputs": {}
}

Cline

1. Cài đặt các phụ thuộc:
   Như trên.
2. Cấu hình .env:
   Thiết lập ROOT_PATH, HOST, và PORT.
3. Thêm vào Cline:
   Đăng ký MCP server trong cấu hình Cline.
4. Khởi động máy chủ:
   python main.py
5. Kiểm tra hoạt động:
   Đảm bảo MCP server khả dụng.

Ví dụ JSON:

{
  "mcpServers": {
    "tsuki_mcp_filesystem": {
      "command": "python",
      "args": ["main.py"]
    }
  }
}

Bảo mật API Key:

{
  "env": {
    "ROOT_PATH": "/path/to/your/search/directory"
  },
  "inputs": {}
}

Cách sử dụng MCP này trong flows

Sử dụng MCP trong FlowHunt

Để tích hợp máy chủ MCP vào quy trình FlowHunt, hãy thêm thành phần MCP vào flow của bạn và kết nối với AI agent:

Nhấn vào thành phần MCP để mở bảng cấu hình. Trong phần cấu hình hệ thống MCP, hãy chèn thông tin máy chủ MCP của bạn theo định dạng JSON sau:

{
  "tsuki_mcp_filesystem": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

Sau khi cấu hình, tác nhân AI sẽ có thể sử dụng MCP này như một công cụ với đầy đủ chức năng và khả năng của nó. Hãy nhớ đổi “tsuki_mcp_filesystem” thành tên thực tế của MCP server bạn đang sử dụng và thay URL bằng địa chỉ MCP server của bạn.

Tổng quan

Dựa trên các thông tin hiện có, tsuki_mcp_filesystem_server là một máy chủ MCP tối giản nhưng chuyên biệt cho tìm kiếm hệ thống tệp cục bộ. Nó cung cấp các tính năng cần thiết và cấu hình rõ ràng, nhưng còn thiếu các primitive MCP nâng cao như prompt, roots hoặc sampling. Tính hữu dụng cao cho các trường hợp chuyên biệt, nhưng với các ứng dụng rộng hơn sẽ cần bổ sung thêm tính năng.

Điểm MCP