iflow-mcp_alpic-ai-mcp-server-template 0.1.0__py3-none-any.whl

iflow_mcp_alpic_ai_mcp_server_template-0.1.0.dist-info/METADATA

@@ -0,0 +1,120 @@
+Metadata-Version: 2.4
+Name: iflow-mcp_alpic-ai-mcp-server-template
+Version: 0.1.0
+Summary: Python MCP Server template
+Author: Alpic
+Keywords: mcp,llm,alpic,python
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+Requires-Dist: black>=25.1.0
+Requires-Dist: mcp
+
+# mcp-server-template-python
+
+A very simple Python template for building MCP servers using Streamable HTTP transport.
+
+## Overview
+This template provides a foundation for creating MCP servers that can communicate with AI assistants and other MCP clients. It includes a simple HTTP server implementation with example tools, resources & prompts to help you get started building your own MCP integrations.
+
+## Deploy
+
+Use the following button to clone the repository and directly deploy the server to Alpic
+
+[![Deploy on Alpic](https://assets.alpic.ai/button.svg)](https://app.alpic.ai/new/clone?repositoryUrl=https%3A%2F%2Fgithub.com%2Falpic-ai%2Fmcp-server-template-python)
+
+## Prerequisites
+- Install uv (https://docs.astral.sh/uv/getting-started/installation/)
+
+## Installation
+
+1. Clone the repository:
+
+```bash
+git clone git@github.com:alpic-ai/mcp-server-template-python.git
+cd mcp-server-template-python
+```
+
+2. Install python version & dependencies:
+
+```bash
+uv python install
+uv sync --locked
+```
+
+## Usage
+
+Start the server on port 3000:
+
+```bash
+uv run main.py
+```
+
+## Running the Inspector
+
+### Requirements
+- Node.js: ^22.7.5
+
+### Quick Start (UI mode)
+To get up and running right away with the UI, just execute the following:
+```bash
+npx @modelcontextprotocol/inspector
+```
+
+The inspector server will start up and the UI will be accessible at http://localhost:6274.
+
+You can test your server locally by selecting:
+- Transport Type: Streamable HTTP
+- URL: http://127.0.0.1:3000/mcp
+
+## Development
+
+### Adding New Tools
+
+To add a new tool, modify `main.py`:
+
+```python
+@mcp.tool(
+    title="Your Tool Name",
+    description="Tool Description for the LLM",
+)
+async def new_tool(
+    tool_param1: str = Field(description="The description of the param1 for the LLM"), 
+    tool_param2: float = Field(description="The description of the param2 for the LLM") 
+)-> str:
+    """The new tool underlying method"""
+    result = await some_api_call(tool_param1, tool_param2)
+    return result
+```
+
+### Adding New Resources
+
+To add a new resource, modify `main.py`:
+
+```python
+@mcp.resource(
+    uri="your-scheme://{param1}/{param2}",
+    description="Description of what this resource provides",
+    name="Your Resource Name",
+)
+def your_resource(param1: str, param2: str) -> str:
+    """The resource template implementation"""
+    # Your resource logic here
+    return f"Resource content for {param1} and {param2}"
+```
+
+The URI template uses `{param_name}` syntax to define parameters that will be extracted from the resource URI and passed to your function.
+
+### Adding New Prompts
+
+To add a new prompt , modify `main.py`:
+
+```python
+@mcp.prompt("")
+async def your_prompt(
+    prompt_param: str = Field(description="The description of the param for the user")
+) -> str:
+    """Generate a helpful prompt"""
+
+    return f"You are a friendly assistant, help the user and don't forget to {prompt_param}."
+
+```

iflow_mcp_alpic_ai_mcp_server_template-0.1.0.dist-info/RECORD

@@ -0,0 +1,6 @@
+main.py,sha256=U6IcGowDECS-x7DQCrJnJPxATsf4loj29UVL4F-9eeM,1150
+iflow_mcp_alpic_ai_mcp_server_template-0.1.0.dist-info/METADATA,sha256=dBZXYFfBpGGHJNrOlzBht4lIRsmqjESKuxKYsxPKBDA,3184
+iflow_mcp_alpic_ai_mcp_server_template-0.1.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+iflow_mcp_alpic_ai_mcp_server_template-0.1.0.dist-info/entry_points.txt,sha256=nOcvY4wm0kmeu0EKfeL-hvkCmExUb3CPoqIsql16X9o,41
+iflow_mcp_alpic_ai_mcp_server_template-0.1.0.dist-info/top_level.txt,sha256=ZAMgPdWghn6xTRBO6Kc3ML1y3ZrZLnjZlqbboKXc_AE,5
+iflow_mcp_alpic_ai_mcp_server_template-0.1.0.dist-info/RECORD,,

iflow_mcp_alpic_ai_mcp_server_template-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.10.2)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

iflow_mcp_alpic_ai_mcp_server_template-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+mcp-server = main:main

iflow_mcp_alpic_ai_mcp_server_template-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+main

main.py

@@ -0,0 +1,53 @@
+"""
+MCP Server Template
+"""
+
+from mcp.server.fastmcp import FastMCP
+from pydantic import Field
+
+import mcp.types as types
+
+mcp = FastMCP("Echo Server")
+
+
+@mcp.tool(
+    title="Echo Tool",
+    description="Echo the input text",
+)
+def echo(text: str = Field(description="The text to echo")) -> str:
+    return text
+
+
+@mcp.resource(
+    uri="greeting://{name}",
+    description="Get a personalized greeting",
+    name="Greeting Resource",
+)
+def get_greeting(
+    name: str,
+) -> str:
+    return f"Hello, {name}!"
+
+
+@mcp.prompt("")
+def greet_user(
+    name: str = Field(description="The name of the person to greet"),
+    style: str = Field(description="The style of the greeting", default="friendly"),
+) -> str:
+    """Generate a greeting prompt"""
+    styles = {
+        "friendly": "Please write a warm, friendly greeting",
+        "formal": "Please write a formal, professional greeting",
+        "casual": "Please write a casual, relaxed greeting",
+    }
+
+    return f"{styles.get(style, styles['friendly'])} for someone named {name}."
+
+
+def main():
+    """Main entry point for the MCP server"""
+    mcp.run()
+
+
+if __name__ == "__main__":
+    main()