🛠️ Personal Utility Toolkit — MCP Server

A remote MCP server built with FastMCP and deployed on Railway. Plug it into Claude Desktop and get 17 utility tools instantly — no setup, no local dependencies.

⚡ Quick Connect (Remote — No Installation Needed)

Add this to your claude_desktop_config.json:

Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "personal-toolkit-remote": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://web-production-2f9c2.up.railway.app/mcp"]
    }
  }
}

Requires: Node.js installed on your machine.
Restart Claude Desktop after saving — that's it! 🎉

🧰 Available Tools

📝 Text Tools

Tool	Description
`word_count`	Count words, characters, sentences, paragraphs
`reverse_text`	Reverse any string
`text_to_uppercase`	Convert text to UPPERCASE
`text_to_lowercase`	Convert text to lowercase
`count_vowels`	Count vowels and consonants
`count_character`	Count occurrences of a specific character
`character_frequency`	Frequency of every character ranked by count
`extract_emails`	Pull all email addresses from a block of text
`generate_password`	Generate a secure random password

🔢 Math Tools

Tool	Description
`basic_calculator`	Safely evaluate math expressions (`sqrt`, `log`, `sin`, etc.)
`unit_converter`	Convert length, weight, and temperature units
`prime_check`	Check if a number is prime + get its factors

✅ Todo Tools

Tool	Description
`add_todo`	Add a todo with priority (low / medium / high)
`list_todos`	List all, pending, or completed todos
`complete_todo`	Mark a todo as done by ID
`delete_todo`	Delete a todo by ID
`clear_completed`	Remove all completed todos

💬 Example Prompts

Count the words in: "The quick brown fox jumps over the lazy dog"
Calculate: sqrt(256) + 2 ** 10
Convert 100 miles to km
Is 97 a prime number?
Generate a 20-character password with symbols
Extract emails from: "contact john@example.com or jane@test.org"
Add a high priority todo: "Learn MCP servers"
List all my pending todos

🏃 Run Locally

If you want to run your own instance:

git clone https://github.com/SANDEEP-KR-MAHTO/personal-toolkit-mcp-server.git
cd personal-toolkit-mcp-server
python -m venv venv
venv\Scripts\activate          # Windows (Mac/Linux: source venv/bin/activate)
pip install -r requirements.txt

Add to claude_desktop_config.json:

Windows:

{
  "mcpServers": {
    "personal-toolkit-local": {
      "command": "C:\\path\\to\\venv\\Scripts\\python.exe",
      "args": ["C:\\path\\to\\server.py"]
    }
  }
}

Mac/Linux:

{
  "mcpServers": {
    "personal-toolkit-local": {
      "command": "/path/to/venv/bin/python",
      "args": ["/path/to/server.py"]
    }
  }
}

🚀 Deploy Your Own on Railway

Fork this repo
Go to railway.app → New Project → GitHub Repo
Select your fork → Deploy
Go to Settings → Networking → Generate Domain
Update the URL in your claude_desktop_config.json

🗂️ Project Structure

├── server.py          # MCP server entry point
├── tools/
│   ├── text_tools.py  # Text utility functions
│   ├── math_tools.py  # Math functions
│   └── todo_tools.py  # Persistent todo list (todos.json)
├── Procfile           # Railway start command
└── requirements.txt

🛠️ Built With

FastMCP — MCP server framework
Railway — Deployment platform
mcp-remote — HTTP→stdio bridge for Claude Desktop

Personal Toolkit MCP Server