Skip to main content
Glama
MCP Personal Tools Server

MCP Personal Tools Server

by Myk3rinos

MCP Demo Server

This project is a demonstration server for the Model Context Protocol (MCP). It provides a set of resources and tools to interact with a simple user database.

Architecture

mcp/
├───.gitignore
├───package-lock.json
├───package.json
├───tsconfig.json
├───.git/...
├───build/
│   └───data/...
└───src/
    ├───server.ts
    └───data/
        └───users.json

The server is built with Node.js and TypeScript, using the @modelcontextprotocol/sdk. It communicates over standard I/O using a StdioServerTransport.

The server exposes the following:

  • Resources:

    • user-details: Fetches user profiles from a JSON file.

  • Tools:

    • create-user: Creates a new user in the JSON database.

    • add-note: Adds a note to a local file in the user's documents directory.

Related MCP server: Agent Construct

Installation

  1. Clone the repository.

  2. Install the dependencies:

    npm install
  3. Build the server:

    npm run server:build

Usage

To start the server, run:

npm start

For development, you can use:

npm run server:dev

This will start the server with tsx for automatic recompilation.

Available Scripts

  • npm start: Starts the production server.

  • npm run server:dev: Starts the development server.

  • npm run server:build: Compiles the TypeScript code.

  • npm run server:build:watch: Compiles the TypeScript code in watch mode.

  • npm run server:inspect: Inspects the server using the MCP Inspector.

Resources

user-details

  • Description: Get a user's details from the database.

  • URI: users://{userId}/profile

  • MIME Type: application/json

Tools

create-user

  • Description: Create a new user in the database.

  • Parameters:

    • name (string)

    • email (string)

    • address (string)

    • phone (string)

    • password (string)

add-note

  • Description: Adds a new line to the notes file.

  • Parameters:

    • text (string): The text to add to the notes file.

Available Tools

2 tools
add-noteB

Ajoute une nouvelle ligne au fichier de notes

Inputs: text (required).

create-userB

Create a new user in the database

Inputs: name (required), email (required), address (required), phone (required), +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 2 tools

    Disambiguation5/5

    The two tools have completely distinct purposes: one handles file-based note-taking (add-note), while the other manages database users (create-user). There is no overlap or ambiguity between these functions, making it easy for an agent to select the correct tool.

    Naming Consistency2/5

    The naming is inconsistent: add-note uses a verb-object pattern with a hyphen, while create-user uses a verb-object pattern with a hyphen but differs in verb choice (add vs. create). Although both use hyphens, the verb inconsistency and lack of a clear naming convention (e.g., all using the same verb style) reduce predictability.

    Tool Count2/5

    With only 2 tools, the server feels severely under-scoped for a 'Personal Tools Server' that implies a broader utility set. This minimal count suggests incomplete coverage of personal tooling needs, such as missing operations for notes (e.g., read, delete) or users (e.g., get, update).

    Completeness2/5

    The tool surface has significant gaps. For notes, there is only an 'add' operation without read, update, or delete capabilities. For users, only 'create' is provided, lacking get, update, delete, or list functions. This incomplete coverage will likely cause agent failures when trying to perform common workflows.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers