自然语言云资源管理工具

OCI-MCP-SmartQueryAI/
├── common/
│   └── utils.py
├── config/
│   └── settings.yaml           # OCI & app configuration (edit this)
├── docs/
│   └── architecture.md
├── mcp_server/
│   ├── mcp_oci_server.py       # FastAPI + MCP server for OCI tools
│   ├── oci_helper.py           # OCI SDK helper methods
│   └── tools/                  # MCP tool registration
├── mcp_client/
│   ├── mcp_client_helper.py    # MCP HTTP client wrapper
│   ├── streamlit_app.py        # (optional) Streamlit entrypoint
│   └── ollama/
│       ├── smart_ollama_mcp_client.py  # CLI AI planner client
│       └── planner_prompt.txt          # System prompt for planner LLM
├── scripts/
│   └── test_mcp_client.py      # Simple direct MCP client test
├── voice-assistant/
│   └── speech_to_text.py       # Future voice integration
├── control_services.sh         # Helper to start/stop MCP server + Streamlit UI
├── requirements.txt
└── README.md

[DEFAULT]
user=ocid1.user.oc1..aaaaaaaa...
fingerprint=aa:bb:cc:dd:...
key_file=/home/<user>/.oci/oci_api_key.pem
tenancy=ocid1.tenancy.oc1..aaaaaaaa...
region=us-phoenix-1

Allow group <group-name> to inspect compartments in tenancy
Allow group <group-name> to read virtual-network-family in tenancy
Allow group <group-name> to inspect images in tenancy
Allow group <group-name> to manage instance-family in compartment <target-compartment-name>

# On the Ollama host
curl -fsSL https://ollama.com/install.sh | sh        # or use the official installer
ollama serve                                        # typically listens on :11434

# Pull a suitable model (e.g., llama3.2)
ollama pull llama3.2

export OLLAMA_URL="http://<ollama-host>:11434/api/chat"
export OLLAMA_MODEL="llama3.2"

# 1) Clone the repository
git clone https://github.com/bhaskaro/OCI-MCP-SmartQueryAI.git
cd OCI-MCP-SmartQueryAI

# 2) Create & activate virtual environment
python -m venv .venv
source .venv/bin/activate      # On Windows: .venv\Scripts\activate

# 3) Install dependencies
pip install --upgrade pip
pip install -r requirements.txt

# 4) Ensure Python can see this repo as a package
export PYTHONPATH="$(pwd)"

oci:
  profile: DEFAULT           # profile from ~/.oci/config
  region: us-phoenix-1       # OCI region
  default_compartment: test  # logical name used by your helper / planner

server:
  host: 0.0.0.0
  port: 8000

streamlit:
  host: 0.0.0.0
  port: 8501

cd OCI-MCP-SmartQueryAI

cat > .env << 'EOF'
# LLM / Ollama
OLLAMA_URL=http://<ollama-host>:11434/api/chat
OLLAMA_MODEL=llama3.2

# MCP server
MCP_BASE_URL=http://localhost:8000/mcp

# (Optional) OCI config overrides
OCI_CONFIG_FILE=$HOME/.oci/config
OCI_PROFILE=DEFAULT
EOF

cp .env.example .env

export OLLAMA_URL=http://my-new-host:11434/api/chat
export OLLAMA_MODEL=llama3.2
export MCP_BASE_URL=http://localhost:8000/mcp

chmod +x control_services.sh

# Start MCP server + Streamlit UI
./control_services.sh start

# Stop both
./control_services.sh stop

# Restart both
./control_services.sh restart

# From repo root, with venv activated and PYTHONPATH set
uvicorn mcp_server.mcp_oci_server:app --host 0.0.0.0 --port 8000

# From repo root
streamlit run mcp_client/ollama/streamlit_ollama_ui.py \
  --server.address 0.0.0.0 \
  --server.port 8501

sudo firewall-cmd --add-port=8501/tcp --permanent
sudo firewall-cmd --reload

# (Similarly for MCP server if exposed remotely)
sudo firewall-cmd --add-port=8000/tcp --permanent
sudo firewall-cmd --reload

python -m mcp_client.ollama.smart_ollama_mcp_client "your natural language query here"

python -m mcp_client.ollama.smart_ollama_mcp_client \
  "get list of instances from test compartment"

{
  "steps": [
    {
      "tool": "get_compartment_ocid",
      "args": { "compartment_name": "test" },
      "save_as": "compartment_ocid"
    },
    {
      "tool": "list_instances",
      "args": { "compartment_ocid": "$compartment_ocid" },
      "save_as": "instances"
    }
  ]
}

python -m mcp_client.ollama.smart_ollama_mcp_client \
  "create compute instance with the name SMARTVMTEST in compartment root/test. \
   Take whatever subnet available in the same compartment."

python -m mcp_client.ollama.smart_ollama_mcp_client \
  "get AUTOTEST instance details from test compartment"

python -m mcp_client.ollama.smart_ollama_mcp_client \
  "terminate AUTOTEST instance in test compartment"

python -m mcp_client.ollama.smart_ollama_mcp_client \
  "get latest image with prefix oracle-linux from compartment root"

python -m mcp_client.ollama.smart_ollama_mcp_client \
  "get all images with prefix oracle-linux from compartment root"