SSOT: Βήματα Επίλυσης Σύνδεσης MCP

Last Updated: 2024-12-07

1. Εντοπισμός Προβλημάτων

1.1 Environment Variables Persistence

# Το πρόβλημα: Οι μεταβλητές δεν διατηρούνται
# Λύση: Προσθήκη στο ~/.bashrc
echo 'export MCP_FILE_SYSTEM_ENABLE=true' >> ~/.bashrc
echo 'export DEBUG="mcp:*,sqlite:*,fs:*"' >> ~/.bashrc
echo 'export PYTHONPATH="/home/alex/projects/LegalTextAnalysis/.venv/bin"' >> ~/.bashrc

1.2 File Permissions Fix

# Διόρθωση δικαιωμάτων στα κρίσιμα directories
chmod 755 ~/projects/LegalTextAnalysis/data
chmod 644 ~/projects/LegalTextAnalysis/data/legal_text.db
chmod -R 755 ~/projects/LegalTextAnalysis/.venv/bin

2. Καθαρή Επανεκκίνηση

2.1 Καθαρισμός Συστήματος

# 1. Τερματισμός όλων των υπηρεσιών
pkill -f mcp-server-sqlite
sudo rm -rf /tmp/mcp*

# 2. Επανεκκίνηση WSL
wsl --shutdown
wsl -d Ubuntu-22.04

2.2 Ρύθμιση Environment

# 1. Φρέσκο environment
cd ~/projects/LegalTextAnalysis
source ~/.bashrc
source .venv/bin/activate

# 2. Επαλήθευση μεταβλητών
env | grep MCP
env | grep PYTHON

3. MCP Server Εκκίνηση

3.1 Βασική Εκκίνηση

# Εκκίνηση με σωστές παραμέτρους
cd ~/projects/LegalTextAnalysis
mcp-server-sqlite --db-path ./data/legal_text.db

3.2 Επαλήθευση Λειτουργίας

# Στο Claude Desktop Console:
import os
import pathlib

# Έλεγχος τρέχοντος directory
print(f"PWD: {os.getcwd()}")
print(f"Data dir exists: {pathlib.Path('./data').exists()}")
print(f"Files: {list(pathlib.Path('./').glob('*'))}")

4. MCP Inspector Ρυθμίσεις

4.1 Transport Configuration

1. Transport Type: STDIO
2. Command: mcp-server-sqlite
3. Arguments: --db-path ./data/legal_text.db
4. Environment Variables (αφαίρεση όλων και προσθήκη):
   - PYTHONIOENCODING=utf-8
   - UV_FORCE_STDIO=1
   - DEBUG=mcp:*,sqlite:*,fs:*
   - MCP_SQLITE_EXPOSE_TABLES=true
   - MCP_FILE_SYSTEM_ENABLE=true