basic-sentiment-mcp-server

Prerequisites

ℹ️ NOTE: This setup is only tested on macOS.

Install Homebrew using these instructions

Python

Any version at or above Python 3.10 should work. Install it like so:

brew install python

Also install the Python package manager uv using the official instructions.

npx

We'll need npx as well. We can get it by installing the Node package manager npm.

Install the npm version manager nvm using these instructions.

Then install Node.js and npm. We'll go with Node version 22 "Jod" (LTS).

nvm install lts/jod

That should give you Node.js, npm, and npx all at once. You can verify the npx installation by running:

npx --version

Install dependencies

At the root of the project directory, run the following:

uv sync

Run and test the server

The MCP SDK is part of the project dependencies, so we can use the MCP Inspector utility.

In the root of the project directory directory, run:

uv run mcp dev server.py

It will output a message like:

MCP Inspector is up and running at http://127.0.0.1:{somePort}

Go ahead and open that URL in your browser to view the MCP Inspector.

For the Transport Type, select STDIO. Click Connect and if that works, you will the inspector view populate.