📌Overview

Purpose: This monorepo serves as a collection of MCP (Model Context Protocol) servers for integrating various AI assistant functionalities.

Overview: The Waldzell MCP Servers monorepo utilizes Turborepo and Yarn 4 Workspaces to manage multiple MCP servers aimed at facilitating AI integrations across platforms. Each package is dedicated to a different API or concept, ensuring modular and scalable server solutions.

Key Features:

Diverse MCP Servers: Includes dedicated servers for APIs such as Yelp Fusion and frameworks like Google TypeScript, promoting flexibility and tailored solutions for various AI integrations.
High-performance Infrastructure: Powered by Turborepo for efficient builds, Yarn for modern package management, and Changesets for version control, ensuring a streamlined development workflow.

Waldzell MCP Servers

This is a Turborepo-powered monorepo containing MCP (Model Context Protocol) servers for various AI assistant integrations.

What's Inside?

Packages

server-yelp-fusionai - MCP server for Yelp Fusion API
server-typestyle - Google TypeScript Style Guide MCP server
server-stochasticthinking - Stochastic thinking MCP server
server-clear-thought - Sequentialthinking fork inspired by James Clear
common - Shared utilities and types

Utilities

This monorepo uses Turborepo with Yarn 4 Workspaces.

Turborepo — High-performance build system for monorepos
Yarn 4 — Modern package management with PnP support
Changesets — Managing versioning and changelogs
GitHub Actions — Automated workflows
Smithery — Deployment platform for MCP servers

Getting Started

Prerequisites

Node.js 18 or higher
Corepack enabled (corepack enable)

Installation

Clone the repository and install dependencies:

git clone https://github.com/waldzellai/mcp-servers.git
cd mcp-servers
yarn install

Development

To develop all packages:

yarn dev

Building

To build all packages:

yarn build

Build outputs will be in each package's dist/ directory.

Testing

yarn test

Linting

yarn lint

Deploying to Smithery

Deploy all packages:

yarn deploy

Deploy specific packages:

yarn smithery:yelp-fusion
yarn smithery:typestyle
yarn smithery:stochastic
yarn smithery:clear-thought

Workflow

Adding a New Feature

Create a new branch
Make your changes
Add a changeset (documents what's changed for version bumping):
```
yarn changeset
```
Push your changes

Releasing New Versions

We use Changesets to manage versions. Create a PR with your changes and Changesets will create a release PR that you can merge to release new versions.

For manual releases:

yarn publish-packages

Adding a New Package

Create a new directory in the packages directory
Initialize the package with yarn init
Add your source code
Update turbo.json pipeline if needed
Add a smithery.yaml file if you want to deploy to Smithery
Run yarn install at the root to update workspaces

Turborepo

Remote Caching

Turborepo can use a remote cache to share build artifacts across machines. To enable Remote Caching:

yarn dlx turbo login
yarn dlx turbo link

MCP Server Documentation

Each MCP server package in this monorepo has its own README with detailed documentation:

Yelp Fusion MCP Server
TypeStyle MCP Server
Stochastic Thinking MCP Server
Clear Thought MCP Server

License

All packages in this monorepo are licensed under the MIT License - see each package's LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a pull request.

waldzell-mcp