AWS VPC Lattice & Kubernetes Gateway API Documentation

🚀 Amazon VPC Gateway MCP Server

A Model Context Protocol (MCP) server that provides source lists, tool access, and manages AWS VPC gateway resources and related documentation.

✨ Features

This server offers five main tools:

1. List Sources (list_sources): Displays all available sources.
2. Show Source Details (show_source): Shows detailed information about a specified source, including its URL and prompts.
3. Search Prompts (search_prompts): Searches all available prompts based on keywords.
4. Show Prompt Details (show_prompt): Displays the template and parameters of a specific prompt.
5. Execute Prompt (execute_prompt): Executes a given prompt using the specified source and context.

📦 Installation

1. Clone the repository:

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

2. Install dependencies:

   npm install
   

3. Build the server:

   npm run build
   

🛠️ Configuration

Edit the config.json file to configure your settings:

{
  "port": 3000,
  "sources": [
    {
      "name": "AWS Documentation",
      "url": "https://docs.aws.amazon.com",
      "prompts": ["Query Key Features", "Configuration Guide", "Best Practices"]
    },
    {
      "name": "AWS Gateway API Controller",
      "url": "https://github.com/aws/aws-application-networking-k8s",
      "prompts": ["Function Support Query", "Issue Tracking"]
    }
  ]
}

💻 Usage Examples

Basic Usage

List Sources

curl http://localhost:3000/api/sources

Show Source Details

curl http://localhost:3000/api/source/AWS Documentation

Search Prompts

curl http://localhost:3000/api/prompts?search=Troubleshooting

Execute Prompt

curl -X POST \
     http://localhost:3000/api/prompt/Create Target Group \
     -H "Content-Type: application/json" \
     -d '{"context": "How to create a target group in VPC gateway?", "source": "AWS Documentation"}'

📚 Available Sources

This server includes the following sources:

1. AWS Documentation (https://docs.aws.amazon.com)

   • Query key features
   • Configuration guide
   • Best practices

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

   • Function support query
   • Issue tracking

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

   • Troubleshooting
   • Best practice guidance

🔧 Technical Details

Project Structure

• src/index.ts: Main entry point and initialization of the server.
• src/tools.ts: Tool definitions and handlers.
• src/data/: Data files
  • prompts.ts: Prompt templates and their parameters.
  • sources.ts: Source definitions and their prompts.
• package.json: Project configuration and dependencies.
• tsconfig.json: TypeScript configuration.
• .gitignore: Git ignore rules.
• build/: Compiled JavaScript output.

Adding New Sources

To add a new source, modify the sources array in src/data/sources.ts:

export const sources = [
  {
    name: 'Your Source',
    url: 'https://your-source-url.com',
    prompts: ['Example Prompt 1 {Placeholder}', 'Example Prompt 2 {Placeholder}']
  }
  // ...Existing sources
];

Adding New Prompts

To add a new prompt template, modify the prompts array in src/data/prompts.ts:

export const prompts = [
  {
    name: 'Your Prompt Template',
    description: 'Describe what this prompt does',
    template: 'Your prompt template with {Parameter} placeholders',
    parameters: ['Parameter']
  }
  // ...Existing prompts
];

Scripts

• npm run build: Build the server and set executable permissions.
• npm run watch: Run in development mode.
• npm test: Run tests (not implemented yet).