Neophyte_Mcp_Server

exquisique/Neophyte_Mcp_Server

3.2

If you are the rightful owner of Neophyte_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 dayong@mcphub.com.

Neophyte is a simple, 'batteries-included' Model Context Protocol (MCP) server designed for testing and learning.

Tools
19
Resources
0
Prompts
0

Neophyte: Prototype MCP Server

Neophyte is a simple, "batteries-included" Model Context Protocol (MCP) server designed for testing and learning. It offers a wide variety of simple yet useful tools to help developers verify MCP client integrations and explore LLM tool-use capabilities.

Before building complex, production-grade MCP servers, it's often helpful to connect a client to a simple, reliable server to understand how connections, tool calls, and validatons work. Neophyte serves exactly this purpose.

🚀 Features

Neophyte includes tools across several categories to test different aspects of LLM interaction (arguments, ranges, text processing, data generation, etc.):

🎲 Randomness & Probability

Test simple tool calls and range arguments.

  • roll_dice: Roll dice with customizable sides.
  • flip_coin: Flip a coin.
  • generate_uuid: Generate unique IDs.
  • pick_random_color: Get a random hex color.

📝 Text Manipulation

Test string handling and processing.

  • count_words: Count words in a string.
  • reverse_text: Reverse a string.
  • text_analyzer: Get readability and sentiment scores.
  • case_converter: Convert case (snake, camel, upper).

🧮 Math & Logic

Test numerical reasoning and precision.

  • simple_calculator: Basic arithmetic.
  • is_prime: Prime number checker.
  • fibonacci: Generate Fibonacci sequences.
  • unit_converter: Convert Temp/Distance units.

🔌 System & Environment

Test live data fetching and latency.

  • get_server_time: Get local server time.
  • echo: Latency/connection check.
  • list_directory: List files in the safe sandbox.

🛠️ Developer Tools

Test structured data handling.

  • validate_json: JSON validation.
  • base64_encode/decode: Data transformation.

🎭 Data Generation (Mock Data)

Test generation of complex content.

  • lorem_ipsum: Generate placeholder text.
  • random_user: Generate fake user profiles (JSON).

🛠️ Installation & Usage

This project is built with uv for fast python package management.

  1. Clone the repository
  2. Run the server: 
    uv run fastmcp dev main.py
    This will start the server and launch the MCP Inspector in your browser for immediate testing.

📦 Dependencies

  • fastmcp: For rapid MCP server development.
  • textstat: For text readability analysis.
  • vaderSentiment: For simple sentiment analysis.
  • faker: For generating mock data.