Psaboia MCP Server Example

This is an experimental project for MCP servers based on TypeScript, serving as a learning resource and testing platform, supporting integration with Calude Desktop and Cursor IDE. The project is derived from tutorials and has expanded more functions and tools, providing a modular design and an extensible sandbox environment.

Developer tools Artificial intelligence chatbots #MCP server #TypeScript #IDE integration #Experimental platform Remote .JavaScript

rating : 2 points

downloads : 13

update time : 2025-04-28

What is MCP Server Playground?

This is a development environment specifically designed for learning and experimenting with the Model Context Protocol (MCP) server. It is built on TypeScript and offers a modular design, allowing for easy expansion of new features and integration with various development tools.

How to use MCP Server Playground?

You can quickly start the server through simple installation steps, and then use it to test integration with Calude Desktop and Cursor IDE, or develop custom MCP features.

Use cases

Suitable for developers to learn the MCP protocol, test AI tool integration, develop custom MCP commands, or serve as a foundation for building more complex MCP servers.

Main features

TypeScript supportBuilt with TypeScript, providing better code structure and type checking

Modular designEasy to expand new commands and features, supporting flexible customization

IDE integrationDesigned specifically for integration with Calude Desktop and Cursor IDE

Experimental sandboxProvides a secure environment to test new tools and modifications

Advantages and limitations

Advantages

Built on mature tutorials, with a gentle learning curve

Modular architecture facilitates feature expansion

Optimized for AI development tool integration

Provides an experimental sandbox environment

Limitations

Currently, the functions are relatively basic

Requires knowledge of the Node.js technology stack

The documentation is still being improved

How to use

Installation

Automatically install via Smithery or manually clone the repository

Install dependencies

Enter the project directory and install the required dependencies

Build the project

Compile the TypeScript code

Start the server

Run the server to start using

Usage examples

Integration with Calude DesktopConfigure the MCP server as the backend service for Calude Desktop

Develop custom commandsAdd new MCP commands to the server

Test Cursor IDE integrationVerify the interaction function between the server and Cursor IDE

Frequently Asked Questions

What prior knowledge is required to use this project?

How to add new MCP commands?

Can this server be used in a production environment?

How to debug server issues?

Related resources

MCP server tutorial article

A detailed tutorial on building the first MCP server

MCP server tutorial video

A video demonstrating how to build an MCP server

Model Context Protocol SDK documentation

Official MCP SDK documentation

Smithery platform

MCP server distribution platform

🚀 MCP Server Playground

This repository serves as a playground for experimenting with an MCP server built using TypeScript. It combines tutorial content with personalized elements, aiming to be both a learning resource and a platform for testing integrations with Calude Desktop and Cursor IDE.

🚀 Quick Start

Prerequisites

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

Installation via Smithery

To automatically install the MCP Server Playground for Calude Desktop via Smithery:

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

Manual Installation

Clone the repository:
```
git clone <repo_url>
cd mcp-server
```
Install dependencies:
```
npm install
```
Build the project:
```
npm run build
```
Start the server:
```
npm start
```

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.

✨ Features

TypeScript-based Server: Leverage TypeScript for better structuring and error checking.
Modular Design: Easily extend with new commands, features, and integrations.
Integration-ready: Designed to work seamlessly with Cursor IDE and Calude Desktop for an efficient development experience.
Scalable Playground: A sandbox environment for experimenting with tools and making modifications beyond the tutorial examples.

📚 Documentation

Background

This project is based on the following materials:

The original tutorial provided a foundation, which I have expanded upon. In addition to the examples in the tutorial, I plan to add more tools and features to transform the code into a powerful playground for MCP server experiments.

Development

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

Project Structure

mcp-server/
├── 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          # Documentation file

Available Scripts

npm run build: Build the project.
npm run start: Start the server.
npm run test: Run tests.

🤝 Contribution

Contributions are welcome! Please check CONTRIBUTING.md for more information.

📖 References

📄 License

Project License

📌 Notes

This project aims to provide a flexible and powerful environment for MCP server experimentation and learning. Through community efforts, we hope to continuously improve and expand its functionality.