own-mcp-server

Anup-repo/own-mcp-server

3.2

If you are the rightful owner of own-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

This repository demonstrates how to use the Model Context Protocol (MCP) to connect Claude Desktop with custom tools and data sources.

Tools
2
Resources
0
Prompts
0

🧠 Claude Desktop + MCP Tools

This repo demonstrates how to use the Model Context Protocol (MCP) to connect Claude Desktop with your own tools and data sources.

It includes:

  • main.py: A basic MCP tool (e.g., add numbers, greet a user)
  • sticky_note.py: A mini sticky note system that lets Claude create, update, and fetch notes
  • All configured to run immediately after cloning the repo

πŸ“¦ Features

FileDescription
main.pyRegisters a basic MCP server with simple tools
sticky_note.pyAdvanced MCP server with note-taking tools
notes.jsonStorage file for sticky notes

πŸ›  Requirements


πŸš€ Quick Start

1. Clone the Repository

git clone https://github.com/Anup-repo/own-mcp-server.git
cd own-mcp-server

2. Set Up Virtual Environment

python -m venv .venv
source .venv/bin/activate  # or .venv\Scripts\activate on Windows

3. Install uv

You can install uv via pip:

pip install uv

Official docs: https://docs.astral.sh/uv/getting-started/installation

4. Create and Initialize MCP Project

uv init .
uv add "mcp[cli]"

5. Create MCP Server

uv run mcp install main.py

6. Run the MCP Server

You’ll now see Demo as a tool in Claude Desktop. Try:

β€œAdd 3 + 2”

7. Run Sticky Note Server (sticky_note.py)

uv run mcp install sticky_note.py

πŸ§ͺ Example Use Cases in Claude

  1. Create Notes
  • Ask Claude: Create 10 sticky notes about RCB.
  1. Get Specific Note Get sticky note with ID 3.

  2. Explore Resources Click on βž• and select get_latest_note. Then ask: Summarize this note in 5 lines.

  3. Summarize All Notes Click βž•, select notes://example, then run note_summary.

Claude will summarize your sticky notes using the custom prompt.

🧱 File Structure

mcp-server/
β”‚
β”œβ”€β”€ main.py                # Basic add/greeting tool
β”œβ”€β”€ sticky_note.py         # Sticky note toolset
β”œβ”€β”€ notes.json             # Note storage
β”œβ”€β”€ pyproject.toml         # MCP project metadata
└── README.md              # This file

πŸ›  Troubleshooting

If the tools don’t show up in Claude Desktop:

Restart Claude Desktop

Go to Settings β†’ Developer β†’ Linked Servers

If not linked:

Click Edit Config

Update the full path to uv:

{
  "uv": "/your/full/path/to/uv"
}

You can find the path using:

which uv       # macOS/Linux
where uv       # Windows

Save, close, and reopen Claude Desktop

Checkout medium article for more details: Understanding MCP: A Bridge Between AI and External Data