Time-MCP

time-mcp

A minimal agentic AI system that answers time-related and general questions using a tool-augmented LLM pipeline.

Features

Flask API: Provides the current timestamp.
MCP Agent Server: Reasoning agent that detects user intent, calls tools (like the time API), engineers prompts, and interacts with an LLM via OpenRouter (OpenAI-compatible API).
Streamlit UI: Simple chat interface to talk to the AI agent.

Setup

1. Clone and Install Dependencies

pip install -r requirements.txt

2. Environment Variable

Set your OpenRouter API key (get one from https://openrouter.ai):

export OPENROUTER_API_KEY=sk-...your-key...

3. Run the Servers

Open three terminals (or use background processes):

Terminal 1: Flask Time API

python flask_api.py

Terminal 2: MCP Agent Server

python mcp_server.py

Terminal 3: Streamlit UI

streamlit run streamlit_ui.py

The Streamlit UI will open in your browser (default: http://localhost:8501)

Usage

Ask the agent any question in the Streamlit UI.
If you ask about the time (e.g., "What is the time?"), the agent will call the Flask API, fetch the current time, and craft a beautiful, natural response using the LLM.
For other questions, the agent will answer using the LLM only.

Architecture

[Streamlit UI] → [MCP Agent Server] → [Tools (e.g., Time API)]
                            ↓
                        [LLM via OpenRouter]

The MCP agent detects intent, calls tools as needed, engineers prompts, and sends them to the LLM.
Easily extensible to add more tools (just add to the MCPAgent class).

Customization

Add more tools: Implement new methods in MCPAgent and update self.tools.
Improve intent detection: Extend detect_intent() in MCPAgent.
Change LLM model: Update the model field in call_llm().

Requirements

Python 3.7+
See requirements.txt for dependencies.

Credits

Built using Flask, Streamlit, OpenRouter, and Python.
Inspired by agentic LLM design patterns.

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

hybrid server

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

An agentic AI system that answers time-related questions by calling a time API tool and general questions using an LLM, accessible through a simple chat interface.

Related MCP Servers

MCP: Multi-Agent Control Point
Gomezzz299
-
security
F
license
-
quality
A server that routes user questions to specialized agents (date, location, weather) or an LLM expert, with a simple Streamlit web interface for easy interaction.
Last updated -
Python
MCP-RAG
ANSH-RIYAL
-
security
F
license
-
quality
An agentic AI system that orchestrates multiple specialized AI tools to perform business analytics and knowledge retrieval, allowing users to analyze data and access business information through natural language queries.
Last updated -
1
Python
MCPCurrentTime
mattjwarren
-
security
A
license
-
quality
A Model Context Protocol server that provides the current time in any timezone with customizable formatting, allowing AI assistants to access accurate time information.
Last updated -
Python
MIT License
MCPlanManager
donway19
A
security
A
license
A
quality
An AI agent task management system that provides structure and visualization for long-term task planning with support for the Model Context Protocol (MCP) standard.
Last updated -
15
1
Python
MIT License

View all related MCP servers