Minimal MCP Inix Server

A Python MCP Server demo exposed via nix, offering a stub location and a current-time tool for MCP clients.

python

3

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mccartykim-minimal-mcp-in-nix": {
      "command": "nix",
      "args": [
        "run",
        "github:mccartykim/minimal-mcp-in-nix"
      ]
    }
  }
}

This minimal MCP Server is a Python-based demo wired through Nix, exposing a stub location and a simple time-tool to illustrate how MCP clients can interact with a server. It’s useful for experimentation, client development, and learning how to integrate MCP endpoints into your workflows.

How to use

You use this MCP Server with an MCP client to discover its stub location and to invoke the current time tool. With a compatible client, you can request the location value and run the time tool to see the current timestamp, enabling quick validation of client interactions and response handling. The server is designed for quick, hands-on testing rather than production workloads.

How to install

Prerequisites: ensure you have a supported runtime environment for MCP, including a mechanism to run the MCP server command shown below.

nix run github:mccartykim/minimal-mcp-in-nix

Additional details

Configuration is minimal. The server runs locally via a nix-based command. There are two built-in capabilities: a stub location descriptor and a current time tool. You can extend or adapt these capabilities in your client code as needed.