MCP Fabric

MCP织物

一个Kubernetes原生平台，用于使用自定义资源定义（CRD）以声明方式部署和管理AI代理。

./docs/header.png

概述

MCP Fabric允许您将AI代理定义为Kubernetes资源。操作员自动配置所有必要的基础设施，包括部署、服务、ConfigMaps和内置安全强化的网络策略。

┌─────────────────────────────────────────────────────────────┐
│                     MCP Fabric Framework                    │
├─────────────────────────────────────────────────────────────┤
│  ┌─────────────┐     watches      ┌─────────────────────┐   │
│  │  Operator   │ ───────────────► │ Agent/Route/Tool CRs│   │
│  └─────────────┘                  └─────────────────────┘   │
│         │ creates                                           │
│         ▼                                                   │
│  ┌─────────────────────────────────────────────────────┐    │
│  │              Agent Deployments                      │    │
│  └─────────────────────────────────────────────────────┘    │
│         ▲                                                   │
│         │ routes requests                                   │
│  ┌─────────────┐                                            │
│  │   Gateway   │ ◄──── HTTP/MCP ────── Clients              │
│  └─────────────┘                                            │
└─────────────────────────────────────────────────────────────┘

特性

• 声明性代理定义：使用CRD定义具有系统提示、模型配置和工具访问权限的代理
• 自动化基础设施：操作员创建部署、服务、ConfigMap和网络策略
• 默认安全：非根容器、只读文件系统、丢弃功能、网络隔离
• 灵活的路由：通过基于名称或意图的正则表达式匹配将请求路由到代理
• 工具包：将Python工具捆绑到OCI映像中，并从代理引用它们
• MCP协议支持：本地模型上下文协议集成

组件

快速开始

先决条件

• Kubernetes集群（1.28+）
• kubectl已配置
• 用于基岩访问的AWS凭据（或替代LLM提供商）

安装

# Install CRDs
kubectl apply -f operator/config/crd/bases/

# Deploy operator
kubectl apply -k deploy/kustomize/base/operator/

# Deploy gateway
kubectl apply -k deploy/kustomize/base/gateway/

创建您的第一个代理

apiVersion: fabric.jarsater.ai/v1alpha1
kind: Agent
metadata:
  name: my-assistant
  namespace: mcp-fabric-agents
spec:
  prompt: |
    You are a helpful assistant.
  model:
    provider: bedrock
    modelId: eu.anthropic.claude-3-7-sonnet-20250219-v1:0
    maxTokens: 4096
  envFrom:
    - secretRef:
        name: aws-bedrock-credentials

kubectl apply -f my-agent.yaml

调用代理

curl -X POST http://agent-gateway:8080/v1/invoke \
  -H "Content-Type: application/json" \
  -d '{
    "agent": "my-assistant",
    "query": "Hello, how can you help me?"
  }'

文档

例子

这 examples/ 目录包含演示如何构建代理、工具和共享库的参考实现：

examples/
├── agents/           # Example agent implementations
├── tools/            # Example tool packages
├── libs/             # Shared libraries for agents
└── deploy/           # Sample Kubernetes manifests

看 示例/README.md 了解详情。

建筑

# Build operator and gateway
make docker-build

# Build example agents and tools
make examples

发展

看 Developpent.md 使用Kind进行本地开发设置。

贡献

看 贡献.md 作为指导方针。

安全

看 安全.md 用于安全策略和漏洞报告。

许可证

此项目根据Apache许可证2.0获得许可-请参阅 许可证 了解详情。