MCP Server POC

Name: MCP Server POC
Author: TarcisioPhilips

@TarcisioPhilips

About MCP Server POC

This project demonstrates how to create and use a Model Context Protocol (MCP) server that can provide custom tools and resources to AI assistants like Claude and others that support the MCP standard. The server includes: - Simple math operations (addition) - Dynamic greeting re

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-server-poc": {
      "command": "uv",
      "args": [
        "init"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is MCP Server POC?

A proof-of-concept implementation of a Model Context Protocol (MCP) server for AI assistant note-taking. It provides custom tools and resources to add, fetch, and summarize notes, and is designed for use with MCP-capable assistants like Claude and Cursor.

How to use MCP Server POC?

Install Python 3.11, clone the repo, set up a virtual environment, install dependencies, and run uv run mcp to start the server. For integration with Cursor, configure the absolute path to main.py in ~/.cursor/mcp.json.

Key features of MCP Server POC

add_note(note) tool: Appends a note to notes.txt
notes://latest resource: Retrieves the most recent note from the file
note_summary_prompt() prompt: Asks the AI to summarize all stored notes
All notes are persisted locally in a plain text file (notes.txt)
Uses stdio transport for communication with client applications

Use cases of MCP Server POC

Quickly capture and retrieve notes with an AI assistant
Prototype MCP server capabilities for note-management workflows
Experiment with custom tools, resources, and prompts in a local environment
Serve as a learning example for building MCP-based integrations

FAQ from MCP Server POC

What tools and resources does the server provide?

It offers the add_note tool to append a note, the notes://latest resource to fetch the latest note, and the note_summary_prompt to request a summary of all notes.

Where are notes stored?

Notes are saved in a file named notes.txt in the project root directory. The file is created automatically if it does not exist.

What runtime environment is required?

Python 3.11 and the packages listed in requirements.txt (including the MCP SDK) are needed. Optionally, the mcp[cli] extras can be installed.

How do I integrate the server with Cursor IDE?

Create or edit ~/.cursor/mcp.json (Windows: C:\Users\<username>\.cursor\mcp.json) with a JSON entry specifying the Python command and the absolute path to main.py, then restart Cursor.

What transport method does the server use?

The server uses stdio (standard input/output) as its transport mechanism, which means it communicates via command-line input/output streams.

Comments

More Other MCP servers

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K