Amazon VPC Lattice MCP Server

Un servidor Model Context Protocol (MCP) per a llistat de fonts, que ofereix eines per accedir i gestionar recursos VPC Lattice d'AWS i la documentació relacionada.

Funcionalitats

El servidor proporciona cinc eines principals:

1. list_sources: Llista totes les fonts disponibles amb les seves URL i exemples de prompts
2. get_source_prompts: Obtén exemples de prompts per a una font específica
3. list_amazon_vpc_lattice_prompts: Llista totes les plantilles de prompts disponibles
4. get_amazon_vpc_lattice_prompts: Obtén detalls d'una plantilla de prompt específica
5. vpc_lattice_cli: Executa comandes AWS CLI VPC Lattice per gestionar recursos VPC Lattice

Instal·lació

Este projecte està construït amb TypeScript i utilitza mòduls ES. Tingues en compte que instal·lar github-mcp-server també és molt recomanable per facilitar els prompts de desenvolupament.

1. Clona el repositori:

git clone https://github.com/awslabs/amazon-vpc-lattice-mcp-server.git
cd amazon-vpc-lattice-mcp-server

2. Instal·la les dependències:

npm install

3. Compila el servidor:

npm run build

El script de compilació compilarà el codi TypeScript i establirà els permisos d'executable adequats.

Configuració

Afegeix el servidor al teu fitxer de configuració MCP (ubicat a ~/Library/Application Support/Code/User/globalStorage/asbx.amzn-cline/settings/cline_mcp_settings.json):

{
  "mcpServers": {
    "amazon-vpc-lattice": {
      "command": "node",
      "args": ["/path/to/amazon-vpc-lattice-mcp-server/build/index.js"],
      "disabled": false,
      "autoApprove": [],
      "env": {}
    }
  }
}

Ús

Un cop configurat, pots utilitzar les eines MCP en les teves converses. Tingues en compte que has d'utilitzar list_amazon_vpc_lattice_prompts per descobrir els prompts disponibles, ja que aquests no es descobreixen automàticament com les eines.

Llista de Fonts

use_mcp_tool({
  server_name: "amazon-vpc-lattice",
  tool_name: "list_sources",
  arguments: {}
})

Obtenir Prompts de Font

use_mcp_tool({
  server_name: "amazon-vpc-lattice",
  tool_name: "get_source_prompts",
  arguments: {
    source_name: "AWS Documentation"
  }
})

Llista de Prompts Amazon VPC Lattice

use_mcp_tool({
  server_name: "amazon-vpc-lattice",
  tool_name: "list_amazon_vpc_lattice_prompts",
  arguments: {}
})

Detalls del Prompt Amazon VPC Lattice

use_mcp_tool({
  server_name: "amazon-vpc-lattice",
  tool_name: "get_amazon_vpc_lattice_prompts",
  arguments: {
    prompt_name: "setup_eks_controller"
  }
})

VPC Lattice CLI

L'eina vpc_lattice_cli proporciona una interfície programàtica per a operacions VPC Lattice d'AWS a través de l'AWS CLI.

Funcionalitats

• Suporta totes les operacions principals de VPC Lattice CLI
• Accepta arguments de comanda com a objectes JavaScript
• Converteix automàticament els paràmetres camelCase a format kebab-case de CLI
• Gestiona banderes booleans, matrius i valors complexos
• Suporta perfils AWS i configuració de regió
• Retorna respostes JSON analitzades

Comandes Disponibles

• Service Network: create-service-network, delete-service-network, get-service-network, list-service-networks, update-service-network
• Service: create-service, delete-service, get-service, list-services, update-service
• Listener: create-listener, delete-listener, get-listener, list-listeners, update-listener
• Rule: create-rule, delete-rule, get-rule, list-rules, update-rule
• Target Group: create-target-group, delete-target-group, get-target-group, list-target-groups, update-target-group
• Target Management: register-targets, deregister-targets, list-targets
• Resource Tags: list-tags-for-resource, tag-resource, untag-resource

Exemples

Llista de xarxes de serveis:

use_mcp_tool({
  server_name: "amazon-vpc-lattice",
  tool_name: "vpc_lattice_cli",
  arguments: {
    command: "list-service-networks",
    region: "us-west-2"
  }
})

Crea una xarxa de serveis:

use_mcp_tool({
  server_name: "amazon-vpc-lattice",
  tool_name: "vpc_lattice_cli",
  arguments: {
    command: "create-service-network",
    args: {
      name: "my-network",
      authType: "NONE"
    }
  }
})

Crea un servei amb etiquetes:

use_mcp_tool({
  server_name: "amazon-vpc-lattice",
  tool_name: "vpc_lattice_cli",
  arguments: {
    command: "create-service",
    args: {
      name: "my-service",
      serviceNetworkIdentifier: "sn-12345",
      tags: [
        { key: "Environment", value: "Production" }
      ]
    }
  }
})

Crea un grup de destinataris:

use_mcp_tool({
  server_name: "amazon-vpc-lattice",
  tool_name: "vpc_lattice_cli",
  arguments: {
    command: "create-target-group",
    args: {
      name: "my-target-group",
      type: "INSTANCE",
      config: {
        port: 80,
        protocol: "HTTP",
        healthCheck: {
          enabled: true,
          protocol: "HTTP",
          path: "/health"
        }
      }
    }
  }
})

Fonts Disponibles

El servidor inclou aquestes fonts:

1. AWS Documentation (docs.aws.amazon.com)

   • Consultes de característiques clau
   • Guia de configuració
   • Millors pràctiques

2. AWS Gateway API Controller per VPC Lattice (aws/aws-application-networking-k8s)

   • Consultes de suport de característiques
   • Seguiment de problemes

3. Kubernetes Gateway API (gateway-api.sigs.k8s.io)

   • Resolució d'errors
   • Guia de millors pràctiques

Desenvolupament

Estructura del Projecte

El projecte està organitzat de la següent manera:

• src/index.ts: Configuració i inicialització principal del servidor
• src/tools.ts: Definicions i manipuladors d'eines
• src/data/: Fitxers de dades
  • prompts.ts: Plantilles de prompts i paràmetres
  • sources.ts: Definicions de fonts i els seus prompts
• package.json: Configuració del projecte i dependències
• tsconfig.json: Configuració de TypeScript
• .gitignore: Regles d'ignoració de Git
• build/: Sortida compilada de JavaScript

Afegeix Fonts Noves

Per afegir fonts noves, modifica la matriu sources a src/data/sources.ts:

export const sources = [
  {
    name: 'Your Source',
    url: 'https://your-source-url.com',
    prompts: [
      'Sample prompt 1 {placeholder}',
      'Sample prompt 2 {placeholder}'
    ]
  }
  // ... existing sources
];

Afegeix Plantilles de Prompts Noves

Per afegir plantilles de prompts noves, modifica la matriu prompts a src/data/prompts.ts:

export const prompts = [
  {
    name: 'Your Prompt Template',
    description: 'Description of what the prompt does',
    template: 'Your prompt template with {parameter} placeholders',
    parameters: ['parameter']
  }
  // ... existing prompts
];

Scripts

• npm run build: Compila el servidor i estableix permisos d'executable
• npm run watch: Mode de vigilància per a desenvolupament
• npm test: Executa proves (actualment no implementat)