MCP Server Playground

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:

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

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