Anup-repo/own-mcp-server
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.
π§ 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
File | Description |
---|---|
main.py | Registers a basic MCP server with simple tools |
sticky_note.py | Advanced MCP server with note-taking tools |
notes.json | Storage file for sticky notes |
π Requirements
- Python 3.8+
- Claude Desktop
uv
(a modern Python package manager)
π 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
- Create Notes
- Ask Claude: Create 10 sticky notes about RCB.
-
Get Specific Note Get sticky note with ID 3.
-
Explore Resources Click on β and select get_latest_note. Then ask: Summarize this note in 5 lines.
-
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