Skip to main content
Glama
markjukerburg

MCP Server Demo

README.md
## Getting Started with MCP in Your Python Project

These instructions are adapted from the original GitHub MCP Python SDK Repository: [Model Context Protocol Python SDK](https://github.com/modelcontextprotocol/python-sdk).

We will use [**uv**](https://github.com/astral-sh/uv) to manage your Python projects for a streamlined and reproducible setup.

### 1. Initialize a New uv-Managed Project

If you're starting fresh, initialize a new project:

```bash
uv init mcp-server-demo
cd mcp-server-demo
```
You can then copy the `server.py` file in your new project.

### 2. Add MCP to Your Project
Add the MCP package, including the CLI tools, as a dependency:

```bash
uv add "mcp[cli]"
```

### 3. Run the MCP Development Tools
To use the MCP CLI with uv:

```bash
uv run mcp
```

### 3. Interact with the Tool
If you have [Claude Desktop](https://claude.ai/download), you can start interacting with the tool from the UI by running the following command:

```bash
uv mcp install server.py
```
You can follow this [tutorial](https://modelcontextprotocol.io/quickstart/user) for a step by step initialziation.

Alternatively, you can test it with the MCP Inspector:

```bash
uv mcp dev server.py
```

TDQS

A3.6/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is no possibility of ambiguity or overlap between tools. The tool's purpose is clearly distinct as it is the sole operation available.

Naming Consistency5/5

The single tool follows a consistent verb_noun naming pattern (get_stock_price). Since there are no other tools to compare, it inherently maintains perfect consistency.

Tool Count2/5

One tool is too few for a server named 'MCP Server Demo' which suggests a broader demonstration purpose. It feels thin and limited, lacking coverage for related operations like historical data or portfolio management.

Completeness2/5

The server's domain appears to be stock data, but with only a price-fetching tool, there are significant gaps. Missing operations include historical prices, company info, or trading actions, making the surface severely incomplete for typical stock-related workflows.

Maintenance

ActivityInactive
ResponsivenessNo issues