Skip to main content
Glama
Auxin-io

Hello World MCP Server

by Auxin-io

đź§  Demo MCP Server with Smithery

This repository showcases a demo implementation of a Model Context Protocol (MCP) server using Smithery, designed to help AI agents interact with tools securely and efficiently.

It includes a streamable MCP server that generates a simple Python "Hello World" program and is ready for integration with LibreChat.


📦 Project Structure

File Structure Demo-MCP-Server-Smithery/ ├── safe-mcp-server/ # Secure MCP server using Smithery CLI ├── insecure-python-code/ # Example of insecure code for contrast ├── smithery.yaml # Smithery configuration file └── README.md # You're reading it!

Related MCP server: Hello World MCP Server

🚀 Features

  • Secure MCP Server: Built with Smithery CLI to ensure safe tool interactions.

  • Insecure Code Samples: Included for educational contrast and security awareness.

  • LibreChat Integration: Ready to plug into LibreChat for AI agent communication.

  • Streamable Output: Generates and streams a basic Python script.


🛠️ Requirements

  • Node.js and npm

  • Smithery CLI installed

  • LibreChat (optional for integration)


đź§Ş Getting Started

  1. Clone the repository:

    git clone https://github.com/Auxin-io/Demo-MCP-Server-Smithery.git
    cd Demo-MCP-Server-Smithery
  2. Install dependencies (if applicable).

  3. Run the secure MCP server: cd safe-mcp-server smithery run smithery.yaml

  4. Test the output and explore the insecure code for comparison.

🧑‍💻 Contributing Pull requests are welcome! Feel free to fork the repo and submit improvements or new features.

đź“„ License This project is licensed under the MIT License.

✨ Acknowledgments

Learn More Smithery Documentation LibreChat GitHub

🧑‍💻 Contributing Pull requests are welcome! Feel free to fork the repo and submit improvements or new features.

Available Tools

1 tool
Secure-Agent-MCPSecure Agent MCPC

Returns a safe and trustable message

ParametersJSON Schema
NameRequiredDescriptionDefault
nameNoName to greet, defaults to 'world'world

TDQS

C2/5.0
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure but fails to do so. It does not mention any behavioral traits like safety mechanisms, trustworthiness criteria, response format, or potential side effects. The phrase 'safe and trustable' is too vague to convey actionable information about the tool's behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is very concise—a single sentence—and front-loaded with its main claim. However, it is under-specified rather than efficiently informative, lacking necessary details. It avoids redundancy but at the cost of clarity, so it scores slightly above minimal.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's simplicity (1 parameter, 100% schema coverage, no output schema), the description is incomplete. It fails to explain what 'safe and trustable message' means, how it's generated, or what the return value entails. Without annotations or output schema, the description should provide more context to be useful.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema description coverage is 100%, with the parameter 'name' clearly documented in the input schema. The description adds no additional meaning about parameters beyond what the schema provides, so it meets the baseline of 3 for high schema coverage without compensating value.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose2/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description 'Returns a safe and trustable message' is vague and tautological—it essentially restates the tool name 'Secure Agent MCP' without specifying what the tool actually does. There is no clear verb-resource pairing (e.g., 'greet a user' or 'generate a secure message'), and it fails to distinguish from any siblings (though none exist).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines1/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool, such as in what contexts or scenarios it applies. There are no alternatives mentioned, no prerequisites, and no explicit or implied usage instructions—it's completely lacking in practical guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 1 tool updatev1.0.0
    • First observedSecure-Agent-MCP

TDQS

C2.4/5.0
Disambiguation5/5

With only one tool, there is no possibility of confusion or overlap between tools, as there are no other tools to compare it against. The single tool's purpose is clearly defined and distinct by default.

Naming Consistency5/5

A single tool inherently has perfect naming consistency, as there are no other tool names to compare it with. The name 'Secure-Agent-MCP' stands alone without any conflicting patterns or styles.

Tool Count2/5

A single tool is too few for most server purposes, making it feel thin and limiting functionality. While it might suffice for a minimal 'Hello World' example, it lacks the breadth expected for practical agent interactions in typical domains.

Completeness1/5

The server is severely incomplete; with only one tool that returns a simple message, there is no coverage of any meaningful domain or lifecycle operations. It fails to provide a usable surface for agents to perform tasks beyond a trivial response.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • -
    license
    Not graded
    quality
    Not graded
    maintenance
    A simple demonstration MCP server that provides basic greeting functionality and server information. Enables users to generate hello messages and retrieve server details through tools and resources.
    -
  • -
    license
    C
    quality
    Not graded
    maintenance
    A simple boilerplate MCP server that provides a basic greeting tool for demonstration purposes. Serves as a starting template for developers to quickly create and deploy custom MCP servers.
    1
    16
    -
  • A
    license
    A
    quality
    D
    maintenance
    A simple MCP server that provides a basic greeting tool and serves as a starter template for AWS Lambda deployment. Demonstrates how to build and deploy MCP servers with both local development and cloud deployment capabilities.
    1
    17
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Auxin-io/Demo-MCP-Server-Smithery'

If you have feedback or need assistance with the MCP directory API, please join our Discord server