|
|
@@ -1,5 +1,5 @@
|
|
|
========================================
|
|
|
-MCP FILESYSTEM – SEADISTUS ja KASUTUSJUHEND
|
|
|
+MCP FILESYSTEM (SSE) – SEADISTUS ja KASUTUSJUHEND
|
|
|
========================================
|
|
|
|
|
|
Asukoht serveris: /opt/docker-compose/third/server/mcp-filesystem
|
|
|
@@ -7,54 +7,36 @@ Andmete kaust: /data/mcp-filesystem
|
|
|
Tailscale IP: 100.87.1.24
|
|
|
Serveri hostname: ohmu
|
|
|
|
|
|
+MÄRKUS (2026-09-04): endine stdio-konteiner `mcp-filesystem` on
|
|
|
+eemaldatud. Aktiivne on ainult `mcp-filesystem-sse` (HTTP/SSE,
|
|
|
+port 3100). Juhend kirjeldab seda.
|
|
|
+
|
|
|
------------------------------------------------
|
|
|
1. MIS SEE ON?
|
|
|
------------------------------------------------
|
|
|
-MCP (Model Context Protocol) failiserver võimaldab AI
|
|
|
-assistentidel (opencode, Claude Desktop, VS Code jne)
|
|
|
-lugeda, kirjutada ja hallata faile läbi standardse MCP
|
|
|
-liidese.
|
|
|
+MCP (Model Context Protocol) failiserver võimaldab AI assistentidel
|
|
|
+(opencode, Open WebUI, n8n jne) lugeda, kirjutada ja hallata faile
|
|
|
+üle HTTP/SSE.
|
|
|
|
|
|
------------------------------------------------
|
|
|
2. KUIDAS KÄIVITADA?
|
|
|
------------------------------------------------
|
|
|
cd /opt/docker-compose/third/server/mcp-filesystem
|
|
|
- bash run.sh
|
|
|
+ docker compose up -d
|
|
|
|
|
|
-See käivitab kaks konteinerit:
|
|
|
- a) mcp-filesystem – stdio-põhine (docker-compose)
|
|
|
- b) mcp-filesystem-sse – SSE/HTTP endpoint (docker run)
|
|
|
+Käivitab ühe konteineri:
|
|
|
+ mcp-filesystem-sse – HTTP/SSE endpoint (port 3100)
|
|
|
|
|
|
------------------------------------------------
|
|
|
-3. KONTEINERITE EHITAMINE
|
|
|
+3. KONTEINERI EHITAMINE
|
|
|
------------------------------------------------
|
|
|
-Stdio image:
|
|
|
- docker build -t mcp/filesystem -f src/filesystem/Dockerfile .
|
|
|
-
|
|
|
-SSE image (vajab Node.js + Python mcp-proxy):
|
|
|
+SSE image (vajab Node.js + Python mcp-proxy; base: python:3.13-slim):
|
|
|
docker build -t mcp-filesystem-sse /opt/docker-compose/third/server/mcp-filesystem
|
|
|
|
|
|
------------------------------------------------
|
|
|
-4. ÜHENDAMINE OPENCODE'GA
|
|
|
+4. ÜHENDAMINE
|
|
|
------------------------------------------------
|
|
|
-
|
|
|
-4a. SAMAS MASINAS (kohalik stdio):
|
|
|
- opencode.json:
|
|
|
- {
|
|
|
- "mcp": {
|
|
|
- "filesystem": {
|
|
|
- "type": "local",
|
|
|
- "command": [
|
|
|
- "docker", "run", "-i", "--rm",
|
|
|
- "--mount", "type=bind,src=/data/mcp-filesystem,dst=/projects/data",
|
|
|
- "mcp/filesystem",
|
|
|
- "/projects"
|
|
|
- ]
|
|
|
- }
|
|
|
- }
|
|
|
- }
|
|
|
-
|
|
|
-4b. TEISES MASINAS (üle Tailscale, HTTP/SSE):
|
|
|
+opencode (üle Tailscale / võrgu):
|
|
|
opencode.json:
|
|
|
{
|
|
|
"mcp": {
|
|
|
@@ -65,22 +47,14 @@ SSE image (vajab Node.js + Python mcp-proxy):
|
|
|
}
|
|
|
}
|
|
|
|
|
|
-4c. TEISES MASINAS (üle Tailscale, SSH stdio):
|
|
|
- opencode.json:
|
|
|
- {
|
|
|
- "mcp": {
|
|
|
- "filesystem": {
|
|
|
- "type": "local",
|
|
|
- "command": [
|
|
|
- "ssh", "ardo@100.87.1.24",
|
|
|
- "docker", "exec", "-i", "mcp-filesystem",
|
|
|
- "node", "/app/dist/index.js", "/projects"
|
|
|
- ]
|
|
|
- }
|
|
|
- }
|
|
|
- }
|
|
|
+Open WebUI (Manage Tool Servers):
|
|
|
+ URL: http://mcp-filesystem-sse:3100/mcp
|
|
|
+ Type: MCP (Streamable HTTP)
|
|
|
+ Auth: none
|
|
|
|
|
|
- Eeldus: SSH võti on seadistatud (ssh-copy-id ohmu@100.87.1.24)
|
|
|
+n8n MCP Client:
|
|
|
+ Endpoint URL: http://100.87.1.24:3100/sse
|
|
|
+ Type: SSE
|
|
|
|
|
|
------------------------------------------------
|
|
|
5. MCP TÖÖRIISTAD (AI-le saadaval)
|
|
|
@@ -111,19 +85,9 @@ Pärast ühendamist küsi AI-lt:
|
|
|
------------------------------------------------
|
|
|
Kui kogu süsteem on kadunud:
|
|
|
|
|
|
- 7a. Klooni MCP serverite repo:
|
|
|
- git clone https://github.com/modelcontextprotocol/servers.git
|
|
|
- cd servers
|
|
|
- docker build -t mcp/filesystem -f src/filesystem/Dockerfile .
|
|
|
-
|
|
|
- 7b. Loo SSE image:
|
|
|
- cd /opt/docker-compose/third/server/mcp-filesystem
|
|
|
- docker build -t mcp-filesystem-sse .
|
|
|
-
|
|
|
- 7c. Käivita:
|
|
|
- bash run.sh
|
|
|
-
|
|
|
- 7d. Lisa opencode.json ja taaskäivita opencode.
|
|
|
+ cd /opt/docker-compose/third/server/mcp-filesystem
|
|
|
+ docker build -t mcp-filesystem-sse .
|
|
|
+ docker compose up -d
|
|
|
|
|
|
------------------------------------------------
|
|
|
8. FAILIDE ASUKOHT
|
|
|
@@ -134,10 +98,9 @@ Varukoopia: /backups/docker/mcp-fileserver
|
|
|
------------------------------------------------
|
|
|
9. n8n MCP KLIENT
|
|
|
------------------------------------------------
|
|
|
-n8n (v2.13+) saab kasutada MCP servereid workflow'des.
|
|
|
+n8n (v2.13+) saab kasutada MCP servereid workflowdes.
|
|
|
|
|
|
Seadistus:
|
|
|
- - Loodud: /data/docker/n8n/mcp.json
|
|
|
- Endpoint: http://100.87.1.24:3100/sse
|
|
|
- N8N_MCP_TOOLS_ENABLED=true lisatud docker-compose.env
|
|
|
|
|
|
@@ -146,18 +109,18 @@ Kasutamine n8n-s:
|
|
|
- Uus workflow → otsi "MCP Client" node
|
|
|
- Endpoint URL: http://100.87.1.24:3100/sse
|
|
|
- Type: SSE
|
|
|
- - Nüüd saad workflow'des lugeda/kirjutada faile.
|
|
|
+ - Nüüd saad workflowdes faile lugeda/kirjutada.
|
|
|
|
|
|
------------------------------------------------
|
|
|
10. INTEGREERITUD TEENUSED
|
|
|
------------------------------------------------
|
|
|
MCP kaudu nähtavad:
|
|
|
- /projects/data/ – docker-compose konfiguratsioonid
|
|
|
- /projects/n8n/ – n8n andmebaas ja logid
|
|
|
- /projects/n8n-workflows – 15 eksporditud workflow'd
|
|
|
- /projects/anythingllm/ – dokumendid, vektorbaas
|
|
|
- /projects/open-webui/ – 2410 üleslaetud faili
|
|
|
- /projects/backups/ – varukoopiad
|
|
|
+ /projects/data/ – docker-compose konfiguratsioonid (read-write)
|
|
|
+ /projects/n8n/ – n8n andmebaas ja logid (read-only)
|
|
|
+ /projects/n8n-workflows – eksporditud workflowd (read-only)
|
|
|
+ /projects/anythingllm/ – dokumendid, vektorbaas (read-only)
|
|
|
+ /projects/open-webui/ – üleslaetud failid (read-only)
|
|
|
+ /projects/backups/ – varukoopiad (read-write)
|
|
|
|
|
|
------------------------------------------------
|
|
|
11. LISATEE
|
ardo