jaktestowac/mcp-server-countries
If you are the rightful owner of mcp-server-countries and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
MCP Server Countries is a lightweight MCP Server designed for managing a list of countries, built with TypeScript for learning and prototyping Model Context Protocol (MCP) tools.
MCP Server Countries Demo
MCP Server Countries is a lightweight MCP Server that allows you to manage a list of countries. It is built with TypeScript and designed for learning, prototyping Model Context Protocol (MCP) tools.
Note: This project is used in course Playwright z AI + MCP.
📁 Project Structure
Each directory in this repository (e.g., mcp-server-countries-demo-S01L02, mcp-server-countries-demo-S01L04, mcp-server-countries-demo-S01L06) is a standalone project that corresponds to a specific lesson in the course. You can explore and run each lesson's code independently.
📦 Features
- List all countries
- Get details of a specific country
- Add a new country
- Update country information
- Delete a country
Server is designed to be simple and easy to extend for learning purposes. Is using free and open source https://restcountries.com API to fetch country data.
🛠️ Getting Started
Prerequisites
- Node.js (v18 or newer recommended)
- npm or yarn
Installation
-
Clone the repository:
-
Open a terminal and run:
npm i
Running the Server
- Test with MCP Inspector:
npx -y @modelcontextprotocol/inspector npx -y tsx main.ts
or run directly:
npm run test
-
Use with VS Code
-
Open the
mcp.jsonfile in.vscodefolder -
Click the start server button (above line
"mcp-server-countries") -
Open Chat mode and select agent
-
Type into the chat and ask
What countries do you have?orUse tool to get information about country Poland and its population
Links and Resources
- TypeScript - TypeScript documentation
- modelcontextprotocol/sdk - Model Context Protocol SDK
📞 Contact & Support
Feel free to reach out to us:
- 🌐 Website: jaktestowac.pl
- 💼 LinkedIn: jaktestowac.pl
- 💬 Discord: Polish Playwright Community
- 📧 Support: Check our website for contact details
Learning Resources
We have gathered a collection of resources to help you learn and master Playwright, both in Polish and English. Whether you're a beginner or an advanced user, these resources will help you enhance your skills and knowledge.
🇵🇱 Polish Resources
- Free Playwright Resources - Comprehensive Polish learning materials
- Playwright Basics - YouTube series (Polish)
- Playwright Elements - Advanced concepts (Polish)
- Playwright MCP - MCP course (Polish)
- Discord Community - First Polish Playwright community!
- Playwright Info - first and only Polish Playwright blog
🇬🇧 English Resources
- VS Code Extensions - Our free Playwright plugins
- Playwright Documentation - Official documentation
- Playwright GitHub - Source code and issues
PS. For more resources and updates, follow us on our website and GitHub.
Happy testing and automating tests! 🚀
jaktestowac.pl Team 💚❤️
PS. For more resources and updates, follow us on our website and GitHub.
Built with 💚❤️ for the Playwright and testing automation community