MCP Server Playground

This repository is a playground for experimenting with an MCP Server built with TypeScript. It is a personalized version of the tutorial and video on building an MCP Server, and it is intended both as a learning resource and a platform to test integrations with Calude Desktop and Cursor IDE.

Background

This project is based on the material from:

• Build your first MCP Server with TypeScript in Under 10 Minutes
• MCP Server Tutorial Video

The original tutorial provided a foundation which I have extended. Alongside the examples from the tutorial, I plan to add additional tools and functionalities to evolve this code into a robust playground for MCP Server experiments.

Features

• TypeScript-based server: Leveraging TypeScript for better structure and error-checking.
• Modular design: Easy to extend with new commands, features, and integrations.
• Integration-ready: Designed to work with Calude Desktop and Cursor IDE for an improved development experience.
• Expandable playground: A sandbox environment to experiment with additional tools and modifications beyond the tutorial examples.

Getting Started

Prerequisites

• Node.js (v12 or higher)
• npm (or Yarn, based on your preference)
• TypeScript (if not installed globally)

Installing via Smithery

To install MCP Server Playground for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install mcp-server-playground --client claude

Installation

1. Clone the repository:

   git clone 
   cd mcp-server-playground
   

2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

Configuration

This project uses environment variables. Create a .env file to set your configuration options. If an example file (.env.example) is provided in the future, use it as a template.

Development

• IDE Integration:
  • Designed to work smoothly with Cursor IDE and Calude Desktop.
  • Leverage the built-in tools and extensions supported by these IDEs to maximize productivity.
• Extending the Project:
  • Feel free to add new commands, integrations, or modify existing functionalities.
  • The modular structure of the server makes it easy to plug in additional tools and features.

Project Structure

mcp-server-playground/
├── src/                # Source code directory