GoCopilotAgentToDoList

GoCopilotAgentToDoList

Overview

GoCopilotAgentToDoList is a Go-based HTTP server that provides an API endpoint for retrieving the current time in a specified timezone. The server interacts with a Dockerized Model Context Protocol (MCP) service to fetch the time, making it a practical example of integrating Go, Docker, and external services.

Features

• /mcp/time API endpoint: Accepts a POST request with a timezone and returns the current time for that timezone.
• Docker integration: Uses Docker to run the MCP service for time retrieval.
• JSON-based communication: Both requests and responses use JSON.
• Unit tests: Includes basic unit tests for request and response marshaling.

Prerequisites

• Go 1.18 or later
• Docker installed and running
• MCP Docker image (mcp:latest) available locally
• Windows OS (but code is cross-platform)

Project Structure

go.mod                  # Go module definition
package main.go         # Main application source code
package_main_test.go    # Unit tests for the project
todos.json              # (Reserved for future to-do list features)

Usage

1. Build and Run the Server

Open a terminal in the project directory and run:

go run package\ main.go

The server will start and listen on http://localhost:8080.

2. API Endpoint

POST /mcp/time

• Request Body:

  {
    "timezone": "America/New_York"
  }
  

• Response Body:

  {
    "time": "2025-05-27T12:34:56Z"
  }
  

• Example with curl:

  curl -X POST http://localhost:8080/mcp/time -H "Content-Type: application/json" -d '{"timezone":"America/New_York"}'
  

3. How It Works

• The server receives a POST request at /mcp/time with a JSON body specifying the timezone.
• It marshals the request and pipes it to a Docker container running the MCP service (mcp:latest), specifically the mcp/time command.
• The output from the container is parsed and returned as a JSON response.

Running Tests

To run the unit tests, execute:

go test -v

Extending the Project

• To-Do List Feature: The presence of todos.json suggests future plans for a to-do list API.
• Additional Endpoints: You can add more endpoints by defining new handlers in package main.go.
• Error Handling: Improve error messages and logging for production use.

Troubleshooting

• Ensure Docker is running and the mcp:latest image is available locally.
• If you encounter permission issues with Docker, run your terminal as administrator.
• The server listens on port 8080 by default. Change this in package main.go if needed.

License

This project is provided as-is for educational and demonstration purposes.