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.

Related MCP server: mcp-boilerplate

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 <repo_url>
   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
│   └── index.ts       # Main server implementation
├── build/             # Compiled JavaScript files
├── package.json       # Project dependencies and scripts
├── tsconfig.json     # TypeScript configuration
└── README.md         # Project documentation

Available Scripts

• npm run build - Compiles TypeScript code and sets proper permissions

• npm run prepare - Runs build script (useful for git hooks)

• npm run watch - Watches for changes in TypeScript files

• npm run inspector - Runs the MCP inspector tool

Contributing

Contributions are welcome! If you have suggestions, improvements, or new integrations, please fork the repository and create a pull request with your changes.

References

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

• MCP Server Tutorial Video

• Model Context Protocol SDK Documentation

License

This project is licensed under the MIT License - see the LICENSE file for details.

Notes

This project is a sandbox environment aimed at testing various adaptations and integrations for an MCP Server. Updates and expansions will be made as new tools and ideas are developed.

Roadmap

• Implement additional tool integrations beyond the tutorial examples

• Add comprehensive documentation for each tool

• Create example integrations with Calude Desktop

• Develop custom tools for Cursor IDE integration

• Add testing framework and examples