io.github.ExpertVagabond/oracle-cloud
Oracle Cloud Infrastructure MCP server
التثبيت
أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: .cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).
oracle-cloud-mcpclaude mcp add oracle-cloud -- npx -y oracle-cloud-mcp@1.0.1
{
"mcpServers": {
"oracle-cloud": {
"command": "npx",
"args": [
"-y",
"oracle-cloud-mcp@1.0.1"
]
}
}
}
التوثيق
مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.
المحتويات
oracle-cloud-mcp
MCP server for Oracle Cloud Infrastructure (OCI). Provides access to Compute, Object Storage, Block Storage, Networking, Autonomous Database, and IAM via the official OCI SDK.
Tools (23 total)
Compute (4 tools)
| Tool | Description |
|---|---|
oci_compute_list_instances | List all VM instances in a compartment |
oci_compute_get_instance | Get detailed info for a specific instance |
oci_compute_list_shapes | List available shapes (including Always Free) |
oci_compute_instance_action | START, STOP, RESET, SOFTSTOP, or SOFTRESET an instance |
Object Storage (5 tools)
| Tool | Description |
|---|---|
oci_os_get_namespace | Get the Object Storage namespace |
oci_os_list_buckets | List all buckets in a compartment |
oci_os_create_bucket | Create a new bucket (Standard or Archive) |
oci_os_list_objects | List objects with optional prefix filter |
oci_os_delete_bucket | Delete an empty bucket |
Block Storage (2 tools)
| Tool | Description |
|---|---|
oci_bv_list_volumes | List block volumes |
oci_bv_list_boot_volumes | List boot volumes in an availability domain |
Networking (3 tools)
| Tool | Description |
|---|---|
oci_vcn_list | List Virtual Cloud Networks |
oci_subnet_list | List subnets in a VCN |
oci_vcn_create | Create a new VCN with CIDR blocks |
Autonomous Database (4 tools)
| Tool | Description |
|---|---|
oci_adb_list | List Autonomous Databases (ATP/ADW) |
oci_adb_get | Get database details and connection strings |
oci_adb_start | Start a stopped database |
oci_adb_stop | Stop a running database |
IAM (5 tools)
| Tool | Description |
|---|---|
oci_iam_list_users | List IAM users |
oci_iam_list_groups | List IAM groups |
oci_iam_list_policies | List IAM policies and statements |
oci_iam_list_compartments | List compartments in the tenancy |
oci_iam_list_availability_domains | List availability domains |
Install
npm install
Configuration
Configure OCI credentials in ~/.oci/config:
[DEFAULT]
user=ocid1.user.oc1..xxx
fingerprint=xx:xx:xx:xx:xx
tenancy=ocid1.tenancy.oc1..xxx
region=us-chicago-1
key_file=~/.oci/api_keys/oci_api_key.pem
Add to your Claude Code MCP config:
{
"mcpServers": {
"oracle": {
"type": "stdio",
"command": "node",
"args": ["/path/to/oracle-mcp/index.js"],
"env": {
"OCI_CONFIG_FILE": "~/.oci/config",
"OCI_PROFILE": "DEFAULT",
"OCI_REGION": "us-chicago-1"
}
}
}
}
Environment Variables
| Variable | Description | Required |
|---|---|---|
OCI_CONFIG_FILE | Path to OCI config file | No (defaults to ~/.oci/config) |
OCI_PROFILE | Config profile name | No (defaults to DEFAULT) |
OCI_TENANCY_OCID | Tenancy OCID | No (read from config) |
OCI_REGION | OCI region | No (defaults to us-chicago-1) |
Authentication
Supports two methods:
- Session Token -- uses
security_token_filefrom config (recommended for interactive use) - API Key -- uses RSA key pair with fingerprint (for automation)
Oracle Cloud Free Tier
| Resource | Free Allocation |
|---|---|
| Compute (Ampere A1) | 4 OCPUs, 24 GB RAM |
| Compute (AMD E2.1.Micro) | 2 instances |
| Object Storage | 20 GB Standard + 20 GB Archive |
| Block Storage | 200 GB total |
| Autonomous Database | 2 Always Free databases |
| Outbound Data | 10 TB/month |
Dependencies
@modelcontextprotocol/sdk-- MCP protocol SDKoci-sdk-- Official Oracle Cloud SDK for Node.js
License
الأسئلة الشائعة
ما هو io.github.ExpertVagabond/oracle-cloud؟
Oracle Cloud Infrastructure MCP server
كيف أثبّت io.github.ExpertVagabond/oracle-cloud؟
يعمل على جهازك. في Claude Code: claude mcp add oracle-cloud -- npx -y oracle-cloud-mcp@1.0.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.
هل يحتاج io.github.ExpertVagabond/oracle-cloud إلى مفتاح API؟
لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.
هل io.github.ExpertVagabond/oracle-cloud مفتوح المصدر؟
نعم. شيفرته متاحة على GitHub بترخيص MIT.
من يصون io.github.ExpertVagabond/oracle-cloud؟
ينشره ExpertVagabond. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.
من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.