toyMCP

toyMCP

0
ai_chatbotdatabases

The toyMCP To-Do List Server is a simple API server implementing a To-Do list with CRUD operations using the Model Context Protocol (MCP) and JSON-RPC over HTTP. It features a natural language interface using AI models and is built on Node.js and PostgreSQL, running in Docker containers.

toyMCP To-Do List Server

This project is a simple server implementing a To-Do list CRUD API using Model Context Protocol (MCP) concepts, utilizing JSON-RPC 2.0 over HTTP. It is built with Node.js, Express, and PostgreSQL for data persistence, and it runs in Docker. The server features a JSON-RPC based API for managing To-Do items and a natural language interface using AI models.

Components

  • MCP Server: A JSON-RPC based API server.
  • Agent Framework: A natural language interface to the server.

Setup

  • Requires Node.js, npm, Docker, and Docker Compose.
  • Clone the repository, install dependencies, start the PostgreSQL database, and launch the server.

Running Tests

  • Tests can be run after ensuring the PostgreSQL container is active.
  • Separate commands for unit and integration tests are available.

API Documentation

  • Documentation is available via Swagger UI both locally and through GitHub Pages.