Skip to main content
Glama

Appointment Manager MCP Server

by Samuelr2112

MCP Project

Checkpoint #3: Full MCP Integration with Claude Successfully Implemented

This repository represents the successful completion of the MCP project. The system now features complete Model Context Protocol (MCP) integration with Claude, alongside comprehensive CRUD functionality for appointment management, utilizing FastAPI and PostgreSQL through Docker Compose.

The integration is fully operational and tested, providing seamless communication between Claude and the appointment management system.


Accomplished Features

Backend with FastAPI

  • Implemented complete CRUD API for appointment management:

    • POST /create_appointment - Create a new appointment

    • GET /list_appointments - Retrieve all appointments

    • PUT /update_appointment - Update an existing appointment

    • DELETE /delete_appointment - Delete an appointment

  • Added flexible date parsing supporting ISO 8601 date strings

  • Ensured consistent output formatting for appointment dates

  • Professional error handling and response formatting

Database with PostgreSQL

  • PostgreSQL container fully configured via Docker Compose

  • FastAPI correctly creates and persists appointment records

  • Database maintains stability across container restarts

MCP Integration with Claude (Fully Functional)

  • Complete MCP server implementation with stdio transport

  • Successful Claude integration for all appointment operations

  • Real-time communication between Claude and the appointment system

  • Professional response formatting for business use

Version Control

  • All changes tracked in Git

  • Complete project with working MCP integration

Getting Started

wsl -d Ubuntu cd ~/mcp-project source venv/bin/activate docker-compose up --build -d docker-compose ps curl http://localhost:8000/list_appointments python3 mcp_server.py

Shutdown

# Stop MCP server Ctrl+C # Stop Docker services docker-compose down

Deployment

git add . git commit -m "Your commit message" git push origin main

API Endpoints

  • Create Appointment: POST /create_appointment

  • List Appointments: GET /list_appointments

  • Update Appointment: PUT /update_appointment

  • Delete Appointment: DELETE /delete_appointment

-
security - not tested
F
license - not found
-
quality - not tested

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Enables users to manage appointments through a FastAPI backend with PostgreSQL database. Supports creating, listing, updating, and deleting appointments via natural language interactions through Claude.

  1. Accomplished Features
    1. Backend with FastAPI
    2. Database with PostgreSQL
    3. MCP Integration with Claude (Fully Functional)
    4. Version Control
  2. Getting Started
    1. Shutdown
      1. Deployment
        1. API Endpoints

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/Samuelr2112/mcp-project'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server