tsuki_mcp_filesystem_server Server MCP

Ce face serverul MCP “tsuki_mcp_filesystem_server”?

tsuki_mcp_filesystem_server este un server personalizat compatibil cu Model Context Protocol (MCP), proiectat pentru a facilita căutarea și deschiderea fișierelor din sistemul local de fișiere. Gândit pentru integrarea cu Agent SDK de la OpenAI, expune resurse ale sistemului de fișiere prin MCP, permițând asistenților și agenților AI să interogheze, listeze și acceseze fișiere dintr-un director specificat pe mașina gazdă. Caracteristicile cheie includ detectarea automată a tipului MIME și configurare flexibilă prin variabile de mediu. Prin suportul metodei resources/list, acest server permite fluxuri de dezvoltare care necesită descoperire sau gestionare programatică a fișierelor, permițând uneltelor AI să interacționeze cu fișiere locale într-un mod standardizat și sigur.

Listă de Prompt-uri

Niciun șablon de prompt nu este menționat în repository.

Listă de Resurse

• Resursă Sistem de Fișiere
  Oferă acces la fișierele sistemului local de fișiere, permițând clienților să caute și să listeze fișierele dintr-un director specificat.
• resources/list
  Un endpoint care recuperează o listă de fișiere din directorul țintă, expunându-le ca resurse pentru clienții AI.

Listă de Unelte

• resources/list
  Unealtă care permite listarea fișierelor din directorul local configurat, făcându-le disponibile clienților pentru acțiuni suplimentare.

Cazuri de utilizare pentru acest server MCP

• Descoperire locală de fișiere
  Dezvoltatorii pot folosi serverul pentru a descoperi și lista programatic fișierele dintr-un director țintă, facilitând sarcinile de gestionare a fișierelor.
• Context pentru fișiere pentru LLM-uri
  Permite modelelor lingvistice mari și agenților AI să recupereze liste de fișiere locale, ce pot fi folosite ca context pentru analiză de cod sau documentare.
• Integrare cu Agent SDK
  Funcționează perfect cu OpenAI Agent SDK, permițând agenților să utilizeze capabilitățile de căutare fișiere ca parte a fluxurilor automate complexe.
• Detectare automată a tipului MIME
  Detectează automat tipurile MIME pentru fișiere, util la procesarea sau filtrarea fișierelor după tip.

Cum se configurează

Windsurf

1. Pre-rechizite:
   Asigură-te că Python și pip sunt instalate.
2. Clonează repository-ul:
   git clone https://github.com/yuutotsuki/tsuki_mcp_filesystem_server.git
3. Instalează dependențele:
   pip install -r requirements.txt
4. Configurează mediul:
   Copiază .env.example în .env și editează ROOT_PATH, HOST, PORT și LOG_LEVEL.
5. Înregistrează în Windsurf:
   Adaugă informațiile serverului în configurația MCP a Windsurf.

Exemplu JSON:

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

Securizarea cheilor API:

{
  "env": {
    "ROOT_PATH": "/cale/către/directorul/tău/căutare"
  },
  "inputs": {}
}

Claude

1. Pre-rechizite:
   Instalează Python și dependențele ca mai sus.
2. Configurează mediul:
   Configurează .env cu directorul tău.
3. Integrare cu Claude:
   Adaugă configurația serverului MCP în setările Claude.
4. Pornește serverul:
   python main.py
5. Verifică conexiunea:
   Asigură-te că Claude vede serverul MCP.

Exemplu JSON:

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

Securizarea cheilor API:

{
  "env": {
    "ROOT_PATH": "/cale/către/directorul/tău/căutare"
  },
  "inputs": {}
}

Cursor

1. Clonează și instalează:
   Clonează repository-ul și instalează dependențele.
2. Configurează mediul:
   Copiază și editează .env.
3. Configurează Cursor:
   Adaugă serverul MCP în configurația Cursor.
4. Pornește serverul:
   python main.py
5. Repornește Cursor și verifică:
   Confirmă recunoașterea MCP.

Exemplu JSON:

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

Securizarea cheilor API:

{
  "env": {
    "ROOT_PATH": "/cale/către/directorul/tău/căutare"
  },
  "inputs": {}
}

Cline

1. Instalează dependențele:
   Ca mai sus.
2. Configurează .env:
   Setează ROOT_PATH, HOST și PORT.
3. Adaugă în Cline:
   Înregistrează serverul MCP în configurația Cline.
4. Pornește serverul:
   python main.py
5. Verifică funcționarea:
   Validează vizibilitatea serverului MCP.

Exemplu JSON:

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

Securizarea cheilor API:

{
  "env": {
    "ROOT_PATH": "/cale/către/directorul/tău/căutare"
  },
  "inputs": {}
}

Cum se folosește acest MCP în fluxuri

Folosirea MCP în FlowHunt

Pentru a integra serverele MCP în fluxul tău FlowHunt, începe prin a adăuga componenta MCP în flux și conecteaz-o la agentul AI:

Apasă pe componenta MCP pentru a deschide panoul de configurare. În secțiunea de configurare MCP de sistem, introdu detaliile serverului MCP folosind acest format JSON:

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

După configurare, agentul AI poate folosi acest MCP ca unealtă cu acces la toate funcțiile și capabilitățile sale. Nu uita să schimbi “tsuki_mcp_filesystem” cu numele real al serverului tău MCP și să înlocuiești URL-ul cu adresa serverului tău MCP.

Prezentare generală

Bazat pe informațiile prezente, tsuki_mcp_filesystem_server este un server MCP minim, dar concentrat pe căutarea locală de fișiere. Oferă funcționalități esențiale și configurare clară, dar nu include primitive MCP avansate precum prompt-uri, roots sau suport sampling. Utilitatea sa este ridicată pentru cazuri specializate, însă pentru aplicații mai largi ar fi nevoie de funcționalități suplimentare.

Scor MCP