Oracle Context MCP Server

MCPMarketplace.dev即将推出。 生产MCP服务器的中央目录。此服务器将在启动时列出。

______________________________________________________________________

Oracle OCI上下文MCP服务器

Oracle云基础架构的生产就绪、多租户模型上下文协议（MCP）服务器。为AI代理（Claude、Cursor、VS Code、OCI GenAI）提供对任何OCI租约的安全、自然语言访问——22个服务中的69个工具。

部分 OkOCI 平台：MCP上下文→ 推理网关（NVIDiOCI）→ 部署CLI（OkOCI部署）。

______________________________________________________________________

快速入门-本地（克劳德桌面/光标/VS代码）

uvx oci-context-mcp --print-config

打印准备粘贴的内容 mcpServers 块：

{
  "mcpServers": {
    "oci": {
      "command": "uvx",
      "args": ["oci-context-mcp", "--transport", "stdio"],
      "env": {
        "OCI_COMPARTMENT_ID": "ocid1.compartment.oc1...",
        "OCI_REGION": "us-phoenix-1"
      }
    }
  }
}

需要 紫外线 (brew install uv).用途 ~/.oci/config 自动。

______________________________________________________________________

平台愿景

AI Agent (Claude, Cursor, OCI GenAI, LangChain)
    |
    v
MCP Server  [this repo]
    Context layer: reads OCI state across 22 services
    Gives the AI eyes on the infrastructure
    |
    v
NVIDiOCI Inference Gateway  [roadmap]
    Brain layer: NVIDIA NIM + Oracle GenAI routing
    Generates structured deployment plans
    |
    v
OkOCI Deploy CLI  [roadmap]
    Execution layer: provisions OCI resources
    Deploys websites, APIs, containers from AI-generated plans

一个用户帐户，一个跨租户IAM策略，跨越所有三层。

______________________________________________________________________

ARCSEM堆栈

______________________________________________________________________

工具库存——69个工具，22个服务

* 工具支持 compartment_scope: single | recursive | tenancy

______________________________________________________________________

Docker部署

# Build ARM64 image (matches OCI free tier A1.Flex shape)
export OCIR_NAMESPACE=$(oci artifacts container configuration get-namespace \
  --compartment-id $OCI_COMPARTMENT_ID --query 'data.namespace' --raw-output)

./scripts/push_to_ocir.sh

# Deploy infrastructure
cd infra
cp terraform.tfvars.example terraform.tfvars  # fill in your values
terraform init
terraform apply

Terraform在一次应用中提供了完整的ARCSEM堆栈：

• 容器实例（ARM64，专用子网）
• API网关（公共HTTPS端点）
• NSG（仅限来自API网关子网的端口8000）
• 日志组+监控报警

______________________________________________________________________

多租户SaaS（路线图）

服务器正在扩展到多租户托管平台。用户通过一个交叉租赁IAM策略连接OCI租赁-不存储API密钥。

入职流程（即将到来）：

1. User registers at okoci.dev (email + tenancy OCID)
2. System generates their tenant ID
3. User runs one IAM policy in their tenancy:
     Allow dynamic-group  to read all-resources in tenancy
4. System probes and confirms access
5. User receives API key for the MCP endpoint

看 docs/Main/ARCHITECTURE.md 对于完整的SaaS架构。

______________________________________________________________________

连接OCI生成的AI代理

1. 将图像推送到OCIR并运行 terraform apply
2. 在OCI控制台中：生成AI>代理>创建代理
3. 添加工具：自定义>模型上下文协议
4. 将远程MCP服务器URL设置为 terraform output mcp_server_url
5. 身份验证：实例主体

______________________________________________________________________

认证

实例主体 （OCI托管——推荐）： 自动，无钥匙。容器实例承担动态组角色。

配置文件 （地方发展）： 回落到 ~/.oci/config 自动。

______________________________________________________________________

环境变量

______________________________________________________________________

路线图

当前版本--v2.5（单租户）

• \[x\] 22个OCI服务中的69个工具
• \[x\] STDIO传输——克劳德桌面、光标、VS代码
• \[x\] HTTP传输——Docker、容器实例
• \[x\] ARCSEM堆栈——全地形IaC
• \[x\] ARM64 Docker镜像——兼容OCI免费层
• \[x\] API网关-公共HTTPS、私有CI

v3.0--多租户SaaS

• \[\]根据请求OCIAuthManager（跨租户签名者）
• \[\]租户登记处（OCI自治数据库）
• \[\]API密钥服务（发布、轮换、撤销）
• \[\]登录页面+注册流程
• \[\]API网关上的JWT身份验证策略
• \[\]每个租户的费率限制
• \[\]使用情况仪表板

v3.5--NVIDiOCI推理集成

• \[\]MCP工具： route_inference() --从MCP上下文调用NVIDiOCI网关
• \[\]OCI状态快照传递给推理请求
• \[\]NVIDIA NIM+Oracle GenAI路由
• \[\]结构化部署计划输出格式

v4.0--OkOCI部署命令行界面

• \[\]CLI使用NVIDiOCI部署计划JSON
• \[\]通过Terraform+OCI SDK提供OCI资源
• \[\]网站、API、容器部署目标
• \[\]回滚支持
• \[\]插入现有的ARCSEM堆栈

F4——写操作（并行轨道）

• \[\]编写带有确认+回滚功能的工具
• \[\]启动/停止计算实例
• \[\]创建/删除bucket
• \[\]缩放OKE节点池

______________________________________________________________________

安全

• 实例主体身份验证--未存储或传输凭据
• 跨租户IAM——用户控制访问，通过删除一个策略进行撤销
• 专用子网--容器实例没有公共IP
• API网关-单个公共入口，CORS锁定到网关主机名
• NSG-只能从API网关子网访问端口8000
• OCI保险库——生产环境变量中从不包含的秘密
• 遥测——仅限本地JSONL，没有数据离开主机

______________________________________________________________________

贡献

看 贡献.md.如有疑问：denn.stewartjr@gmail.com

______________________________________________________________________

许可证

麻省理工学院

______________________________________________________________________

免责声明

该项目不隶属于Oracle公司，也不得到Oracle公司的认可。 “Oracle”、“OCI”和“Oracle云基础设施”是Oracle公司的商标。 “NVIDIA”和“NIM”是NVIDIA公司的商标。