# Python Mcp Template

> 🚀 A DevOps-friendly template with CI/CD, Docker, and Documentation-as-Code (DaC) for building MCP server .

- **Type:** MCP server
- **Install:** `agentstack add mcp-hsiangjenli-python-mcp-template`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [hsiangjenli](https://agentstack.voostack.com/s/hsiangjenli)
- **Installs:** 0
- **Category:** [Cloud & Infrastructure](https://agentstack.voostack.com/c/cloud-infrastructure)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [hsiangjenli](https://github.com/hsiangjenli)
- **Source:** https://github.com/hsiangjenli/python-mcp-template
- **Website:** https://hsiangjenli.github.io/python-mcp-template/

## Install

```sh
agentstack add mcp-hsiangjenli-python-mcp-template
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

Python MCP Template 

> A DevOps-friendly template with CI/CD, Docker, and Documentation-as-Code (DaC) for building MCP server

## 🚀 Core Idea

This template leverages **fastmcp** and **FastAPI** to seamlessly integrate MCP functionality while inheriting the original OpenAPI specifications.

## 🌟 Features

- **CI/CD Integration**: Automate your workflows with GitHub Actions.
- **Dockerized Environment**: Consistent and portable development and production environments.
- **Documentation-as-Code**: Automatically generate and deploy documentation using MkDocs. This process also utilizes the `openapi.json` file to ensure API documentation is up-to-date.
- **FastAPI Integration**: Build robust APIs with OpenAPI support.

## 🛠️ Getting Started

### Local Development

1. Install dependencies:
  ```bash
  uv sync
  ```

2. Run the MCP server:
  ```bash
  # stdio
  uv run fastmcp run mcp_tools/main.py
  ```

  ```bash
  # HTTP (Due to CORS middleware conflicts, additional setup is required)
  uv run uvicorn mcp_tools.main_http:starlette_app --host 127.0.0.1 --port 8000
  ```

  > 
  > - https://gofastmcp.com/deployment/http
  > - https://github.com/jlowin/fastmcp/issues/840

### Docker

1. Build the Docker image:
   ```bash
   docker build -t python-mcp-template:latest .
   ```

2. Run the container:
   ```bash
   docker run -i --rm -p 8000:8000 python-mcp-template:latest
   ```

3. Run MCP Server:
  ```json
  {
    "mcpServers": {
      "python-mcp-template": {
        "command": "docker",
        "args": [
          "run",
          "--rm",
          "-i",
          "-p",
          "8000:8000",
          "python-mcp-template:latest"
        ]
      }
    }
  }
  ```

## 📚 Documentation

- Documentation is built using MkDocs and deployed to GitHub Pages.
- To build the documentation locally:
  
  ```bash
  chmod +x scripts/build_docs.sh
  scripts/build_docs.sh
  mkdocs build
  ```

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [hsiangjenli](https://github.com/hsiangjenli)
- **Source:** [hsiangjenli/python-mcp-template](https://github.com/hsiangjenli/python-mcp-template)
- **License:** MIT
- **Homepage:** https://hsiangjenli.github.io/python-mcp-template/

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-hsiangjenli-python-mcp-template
- Seller: https://agentstack.voostack.com/s/hsiangjenli
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.