iflow-mcp_alpic-ai-mcp-server-template 0.1.0__tar.gz

iflow_mcp_alpic_ai_mcp_server_template-0.1.0/PKG-INFO

@@ -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/README.md

@@ -0,0 +1,109 @@
+# 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/iflow_mcp_alpic_ai_mcp_server_template.egg-info/PKG-INFO

@@ -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/iflow_mcp_alpic_ai_mcp_server_template.egg-info/SOURCES.txt

@@ -0,0 +1,9 @@
+README.md
+main.py
+pyproject.toml
+iflow_mcp_alpic_ai_mcp_server_template.egg-info/PKG-INFO
+iflow_mcp_alpic_ai_mcp_server_template.egg-info/SOURCES.txt
+iflow_mcp_alpic_ai_mcp_server_template.egg-info/dependency_links.txt
+iflow_mcp_alpic_ai_mcp_server_template.egg-info/entry_points.txt
+iflow_mcp_alpic_ai_mcp_server_template.egg-info/requires.txt
+iflow_mcp_alpic_ai_mcp_server_template.egg-info/top_level.txt

iflow_mcp_alpic_ai_mcp_server_template-0.1.0/iflow_mcp_alpic_ai_mcp_server_template.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

iflow_mcp_alpic_ai_mcp_server_template-0.1.0/iflow_mcp_alpic_ai_mcp_server_template.egg-info/entry_points.txt

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

iflow_mcp_alpic_ai_mcp_server_template-0.1.0/iflow_mcp_alpic_ai_mcp_server_template.egg-info/requires.txt

@@ -0,0 +1,2 @@
+black>=25.1.0
+mcp

iflow_mcp_alpic_ai_mcp_server_template-0.1.0/iflow_mcp_alpic_ai_mcp_server_template.egg-info/top_level.txt

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

iflow_mcp_alpic_ai_mcp_server_template-0.1.0/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()

iflow_mcp_alpic_ai_mcp_server_template-0.1.0/pyproject.toml

@@ -0,0 +1,15 @@
+[project]
+name = "iflow-mcp_alpic-ai-mcp-server-template"
+version = "0.1.0"
+description = "Python MCP Server template"
+readme = "README.md"
+requires-python = ">=3.11"
+authors = [{ name = "Alpic" }]
+keywords = ["mcp", "llm", "alpic", "python"]
+dependencies = [
+    "black>=25.1.0",
+    "mcp",
+]
+
+[project.scripts]
+mcp-server = "main:main"

iflow_mcp_alpic_ai_mcp_server_template-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+