mcp_server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp_server What's the current time in Karachi?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Python MCP Agent Chatbot
An Agentic AI classroom project built completely in Python. Groq handles model reasoning while a local MCP server supplies tools.
Architecture
Browser -> FastAPI (Python) -> Groq -> MCP Client -> MCP Server (Python) -> Tool
Related MCP server: mcp-datecalc
Files
app.py— FastAPI web backend, Groq agent loop, and MCP clientmcp_server.py— Python MCP server containing three toolstest_mcp.py— MCP discovery and tool-call testindex.html— browser chat interfacepyproject.toml— Python dependencies
Run on Windows
uv sync --cache-dir .uv-cache
uv run --cache-dir .uv-cache uvicorn app:app --reloadOpen http://127.0.0.1:8000.
MCP ko Groq API call ke baghair test karne ke liye:
uv run --cache-dir .uv-cache python test_mcp.pyTry these questions:
25 * 8 + 10 calculate karoKarachi mein abhi kya time hai?Ahmed ki attendance kya hai?
MCP flow
Functions in
mcp_server.pyare registered with@mcp.tool().app.pylaunches that MCP server as a local Python subprocess using stdio.The MCP client calls
list_tools()so Groq can see the available tools.Groq selects a tool and generates its arguments.
The MCP client calls
call_tool()and returns the tool result to Groq.Groq converts the result into a natural-language answer.
The .env file contains the Groq key and is intentionally excluded from Git.
Available Tools
3 toolscalculateA
Safely calculate basic arithmetic, for example (25 * 4) + 10.
Inputs: expression (required). Returns: result
find_studentA
Find a demo student's course, attendance, and enrollment status by name.
Inputs: name (required). Returns: result
get_current_timeA
Get the current date and time for an IANA timezone such as Asia/Karachi.
Inputs: timezone. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
The three tools serve entirely different purposes—arithmetic, time lookup, and student information—with no overlap in functionality. Each tool has a clear, distinct scope that leaves no ambiguity for an agent.
All tool names follow a consistent verb-first pattern: 'calculate', 'get_current_time', and 'find_student' each start with an imperative verb and use snake_case. This makes the naming predictable and uniform across the set.
With only three tools, the count is on the low end but still within the acceptable range for a utility-focused server. Each tool is self-contained and earns its place, though the server feels sparse for a general-purpose name like 'mcp_server'.
Each tool provides a complete single operation for its own small domain (e.g., calculate handles arithmetic, get_current_time handles timezone queries), but there are no supporting or related operations. The lack of a cohesive theme makes it unclear if coverage is adequate, and there are potential gaps like missing timezone listing or student CRUD beyond find.
Maintenance
Related MCP Connectors
Wall-clock awareness for LLM agents. Two tools: elapsed-time-between-turns + day rollover detection.
Connects AI assistants to TrackingTime for querying time entries, projects, tasks, customers, and team data using natural language.
Pay-per-call agent tools: PDF, OCR, translation, news search, prediction markets, web, chain reads.
Time and date math for AI agents: Unix timestamp conversion, DST-correct time zone conversion, durations, epoch arithmetic, cron schedules, and holiday countdowns. Eight tools, no key.
Related MCP Servers
- AlicenseBqualityDmaintenanceProvides computational tools for systematic reasoning, including boolean evaluation, date arithmetic, object counting, state tracking, and format validation, to enhance agent capabilities and eliminate calculation errors in reasoning tasks.74MIT
- AlicenseNot gradedqualityCmaintenanceEnables users to perform date arithmetic, compute differences, add durations, and retrieve calendar facts via natural language or direct tool calls.97 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables LLMs to fetch real-time weather data for any city and perform basic arithmetic operations like addition.MIT
- FlicenseNot gradedqualityDmaintenanceEnables an AI assistant to help students by providing tools for math calculations, attendance tracking, marks analysis, reading PDF notes, searching lecture notes, and checking college regulations.-