veeink-mcp-server 0.2.0

# veeink-mcp-server

A simple [FastMCP](https://pypi.org/project/fastmcp/) server example built with Python.  
This project demonstrates how to expose custom **tools** and **resources** over the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/).

---

## 🚀 Features

- ⚡ Built with [FastMCP](https://pypi.org/project/fastmcp/)  
- 🔧 Provides a simple `add(a, b)` tool  
- 📡 Supports dynamic greeting resources (`greeting://{name}`)  
- 🖥️ Works over **stdio** (default), **SSE**, or **Streamable HTTP** transports  

---

## 📦 Installation

```bash
pip install veeink-mcp-server

Or using uv:

uv tool install veeink-mcp-server

🖥️ Usage

After installation, run the MCP server:

veeink-mcp-server

By default it runs with stdio transport, but you can also configure:

def main() -> None:
    mcp.run(transport="stdio")            # Default
    # mcp.run(transport="sse")            # SSE transport
    # mcp.run(transport="streamable-http") # Streamable HTTP transport

🔧 Example Tools & Resources

This server exposes:

1. Tool: add

@mcp.tool()
def add(a: int, b: int) -> dict:
    """Add two numbers"""
    return {"result": a + b}

✅ Example call:

{"tool": "add", "args": {"a": 2, "b": 3}}

Response:

{"result": 5}

2. Resource: greeting://{name}

@mcp.resource("greeting://{name}")
def get_greeting(name: str) -> str:
    """Get a personalized greeting"""
    return f"Hello, {name}!"

✅ Example call:

{"resource": "greeting://Alice"}

Response:

Hello, Alice!

🛠 Development

Clone the repository:

git clone https://github.com/yourusername/veeink-mcp-server.git
cd veeink-mcp-server

Install in editable mode:

pip install -e .

Run the server:

veeink-mcp-server