aws-sample-gen-ai-mcp-server logo

aws-sample-gen-ai-mcp-server

by jikang-jeong

This sample code project is a fork from aws-samples/Sample-Model-Context-Protocol-Demos with added PostgreSQL database connection and web search (Wikipedia) samples. It provides a foundation for building applications that interact with AI models using the Model Context Protocol.

View on GitHub

Last updated: N/A

What is aws-sample-gen-ai-mcp-server?

This server is a sample application demonstrating the Model Context Protocol (MCP) with added functionality for PostgreSQL database connectivity and web search using Wikipedia. It's built using Python and designed to be easily deployed using Docker.

How to use aws-sample-gen-ai-mcp-server?

To use this server, first start the PostgreSQL database using Docker Compose. Then, set up a Python virtual environment, install the required dependencies from init/requirements.txt, and run the main.py script. Refer to the README for specific instructions and troubleshooting.

Key features of aws-sample-gen-ai-mcp-server

  • Model Context Protocol (MCP) integration

  • PostgreSQL database connection sample

  • Web search (Wikipedia) sample

  • Docker Compose deployment

  • Python 3.13+ compatibility

Use cases of aws-sample-gen-ai-mcp-server

  • Building AI-powered applications that require database interaction

  • Integrating web search capabilities into AI models

  • Demonstrating the use of the Model Context Protocol

  • Prototyping AI applications with PostgreSQL and Wikipedia integration

FAQ from aws-sample-gen-ai-mcp-server

What is the Model Context Protocol (MCP)?

The README doesn't explicitly define MCP. Further research is needed.

How do I start the PostgreSQL database?

Use the command docker-compose -f docker-compose/docker-compose.yml up -d.

What are the prerequisites for running this server?

Python 3.13+ and PostgreSQL (via Docker).

I'm getting an ImportError related to psycopg. What should I do?

Install the PostgreSQL client libraries. On macOS, use brew install libpq and brew link --force libpq. On Ubuntu, use sudo apt-get install libpq-dev.

Where can I find the SQL initialization script?

The SQL initialization script is located at /init/init.sql.