A simple demonstration project to help beginners understand and build Model Context Protocol (MCP) servers with minimal coding experience.
Beginner's Guide to MCP Servers is an MCP project maintained in the astensby/gritai-basic-mcp-server repository. The maintainer describes its purpose as “A simple demonstration project to help beginners understand and build Model Context Protocol (MCP) servers with minimal coding experience”. Read the project documentation for the complete scope.
The project provides a local client configuration using /opt/homebrew/bin/uv. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.
The example declares ALPHA_VANTAGE_API_KEY. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.
Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| hello | ) - Returns a greeting message |
| get_police_incidents | ) - Fetches latest police incidents from Norway |
| get_incidents_by_district | district_name) - Get incidents from a specific police district |
| get_incidents_by_municipality | municipality_name) - Get incidents from a specific municipality |
| search_stock_ticker | company_name) - Search for a company's stock ticker symbol |
| get_stock_price | symbol) - Get current stock price for a ticker symbol |
| get_random_quote | ) - Returns a random motivational quote |
| add_task | description) - Adds a new task to your task list |
| list_tasks | status_filter) - Lists tasks (optionally filter by "pending" or "complete") |
| mark_task_complete | task_id) - Marks a task as complete |
| your_new_tool |
{
"mcpServers": {
"HelloServer": {
"command": "/opt/homebrew/bin/uv",
"args": [
"--directory",
"/path/to/your/project",
"run",
"--with",
"mcp[cli]",
"mcp",
"run",
"server.py"
],
"env": {
"ALPHA_VANTAGE_API_KEY": "YOUR_ALPHA_VANTAGE_API_KEY"
}
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
| Variable | Description | Required |
|---|---|---|
| ALPHA_VANTAGE_API_KEY | Declared in the maintainer’s client configuration. | Check documentation |
Give your coding agent the full DevTools toolbox: traces, network, console, heap snapshots and Lighthouse.
Workers, KV, R2 and D1 by conversation — Cloudflare's official remote servers for building and observability.
Dashboards, Prometheus and Loki queries, incidents and alerts — observability by conversation.
Errors with full context — stack traces, issue triage and AI-powered root-cause analysis from Sentry's server.
Connect Flutter applications with AI coding assistants via the Model Context Protocol.
Enables natural language interaction with Splunk Enterprise and Cloud for searching data and managing resources.