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:

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

Clone the repository:
git clone <repo_url> cd mcp-server-playground
Install dependencies:
npm install
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

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