advocugo-mcp

InspectorGadget/advocugo-mcp

3.2

If you are the rightful owner of advocugo-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

Advocu Go MCP Server is a Model Context Protocol server written in Go, designed to automate the submission of Docker Captain activities to Advocu.

Tools
6
Resources
0
Prompts
0

Advocu Go MCP Server

A Model Context Protocol (MCP) server written in Go that automates submission of Docker Captain activities to Advocu. This project was inpired by the "https://github.com/sarthaksavvy/advocu-docker-mcp" - A fellow Docker Captain from India.

This server exposes typed tools for:

  • Feedback session activities
  • Public speaking
  • Events
  • Resources
  • Amplification
  • Metadata scraping (YouTube + websites)

Tools use strict JSON Schema validation, typed payloads, and an integrated scraper.

Features

Typed MCP Tools

  • JSON Schema validation (fields, enums, lengths, types)
  • Strong Go structs for each tool
  • Automatic decoding via WithState[T](...)

Metadata Scraper

Extracts from any URL:

  • Title
  • Description
  • OpenGraph image
  • Site name
  • Published date

Clean Architecture

  • tools/ → All MCP tools. At the moment.
  • helpers/ → typed helpers + session system
  • constants/ → base URLs, headers
  • main.go → MCP server bootstrap

Setting Up

  1. Clone the repository: 
    git clone https://github.com/InspectorGadget/advocugo-mcp
  2. Navigate to the project directory: 
     cd advocugo-mcp
  3. Build the project: 
    go build -o advocugo-mcp .
  4. Run the MCP server: 
    ADVOCU_API_KEY=<key> ./advocugo-mcp
  5. The server will start listening on port :8181 by default. You can change the port in ./constants/mcp.go.
  6. Use an MCP client to interact with the server and submit activities.

Prompts

Submit Feedback Session

Submit feedback session:
activityDate: 2025-11-01
dockerRepresentative: Jane Doe
modeOfCommunication: Direct call
metrics.timeSpent: 45
title: "Container Image Storage Feedback"
description: "We discussed UX around image pruning, cache visibility, and cleanup workflows."
private: true

Submit Resource

Submit resource:
title: "Zero-to-Prod with Docker Compose"
description: "Step-by-step guide to get a small team productive quickly."
tags: []
activityUrl: https://example.com/docker-compose-guide
activityDate: 2025-10-30
metrics.views: 1200
contentType: Blog post
additionalInfo: "Includes code samples and ready-to-use docker-compose.yml templates."
private: false

Submit Public Speaking

Submit public speaking:
title: "Scaling Images on ECS"
description: "Deep dive into caching layers, parallel pulls, and blue/green rollouts."
tags: []
activityUrl: https://conf.example/schedule/ecs-talk
activityDate: 2025-10-15
format: In-person event
duration: 60
metrics.attendees: 150
additionalInfo: "Live demo of canary deployments and rollback strategies."
private: true

Submit Event

Submit event:
title: "Docker Hack Night"
description: "Hands-on labs with volumes and networking."
dates.start: 2025-12-05
dates.end: 2025-12-05
type: Workshop
format: In-person
duration: Evening event
metrics.attendees: 60
activityUrl: https://meetup.example/docker-hack-night
tags: []
additionalInfo: "Pizza, swag, and open Q&A at the end."
private: true

Submit Amplification

Submit amplification:
activityDate: 2025-11-10
metrics.views: 4200
title: "Compose article cross-post"
description: "Shared my Docker Compose guide to HN and X, replied to comments."
type: ["Repost", "Comment Engagement"]
channel: []
url: https://news.ycombinator.com/item?id=123456
private: false

Scrape content from URL

Scrape content from this URL:
https://www.youtube.com/watch?v=dQw4w9WgXcQ

OR

Scrape content from this URL:
https://example.com/blog/running-docker-in-production

Contributing

Contributions are welcome! Please open issues or submit pull requests for bug fixes, new features, or improvements.

License

This project is licensed under the MIT License.