# Philip Walsh Mcp

> mcp dockerized server for sse or stdio transport

- **Type:** MCP server
- **Install:** `agentstack add mcp-philip-walsh-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [Philip-Walsh](https://agentstack.voostack.com/s/philip-walsh)
- **Installs:** 0
- **Category:** [Integrations](https://agentstack.voostack.com/c/integrations)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [Philip-Walsh](https://github.com/Philip-Walsh)
- **Source:** https://github.com/Philip-Walsh/mcp

## Install

```sh
agentstack add mcp-philip-walsh-mcp
```

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

## About

# 🐳 MCP Server Template

[](https://github.com/your-username/mcp-server-template/actions)

Production-ready MCP server template with Docker, dual transport support, and automated CI/CD.

## ✨ Features

- **MCP 2025-06-18 compliant** - Latest protocol specification
- **Dual transport** - stdio and Streamable HTTP
- **Docker ready** - Multi-arch container with security best practices
- **CI/CD pipeline** - Automated testing and publishing to GitHub Container Registry
- **Template ready** - Click "Use this template" to get started

## 🚀 Quick Start

### Docker (Recommended)

```bash
# Pull from GitHub Container Registry
docker pull ghcr.io/your-username/mcp-server-template:latest

# Or build locally
docker build -t mcp-server .

# Run stdio mode (for MCP clients)
docker run -i --rm mcp-server

# Run HTTP mode (for web integration)
docker run -p 8000:8000 -e MODE=http mcp-server
```

### Direct Python

```bash
# stdio mode
python3 server.py

# HTTP mode
python3 server.py --http --port 8000
```

## 🔧 MCP Client Integration

### Amazon Q / Claude Desktop

Add to your MCP client configuration:

```json
{
  "mcpServers": {
    "my-server": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "ghcr.io/your-username/mcp-server-template:latest"]
    }
  }
}
```

### HTTP Client

```bash
curl http://localhost:8000/mcp \
  -H "Content-Type: application/json" \
  -H "MCP-Protocol-Version: 2025-06-18" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'
```

## 🛠️ Development

### Project Structure

```
├── src/                   # Source code
│   ├── server.py         # MCP server implementation
│   └── entrypoint.sh     # Transport mode switching
├── scripts/              # Development scripts
│   └── setup-hooks.sh    # Git hooks setup
├── examples/             # Usage examples
│   └── client-config.json # Amazon Q configuration
├── docs/                 # Documentation
│   └── SETUP.md         # Setup guide
├── .github/workflows/    # CI/CD automation
├── Dockerfile           # Production container
├── Makefile            # Development commands
└── README.md          # This file
```

### Available Commands

```bash
make build      # Build Docker image
make test       # Run all tests
make test-stdio # Test stdio transport
make test-http  # Test HTTP transport
make clean      # Clean up containers
```

### Adding Tools

Edit `src/server.py` and add your tools to the `handle_request` function:

```python
elif method == 'tools/list':
    return {
        "jsonrpc": "2.0",
        "id": request.get('id'),
        "result": {
            "tools": [
                {"name": "your_tool", "description": "Your tool description", 
                 "inputSchema": {"type": "object", "properties": {...}}}
            ]
        }
    }
```

## 📋 Built-in Tools

- **echo** - Echo back messages
- **get_env** - Get environment variables

## 🧪 Testing

The CI pipeline automatically tests:

- ✅ MCP protocol compliance (2024-11-05 & 2025-06-18)
- ✅ stdio transport functionality
- ✅ HTTP transport with proper headers
- ✅ Tool execution and responses
- ✅ Docker container security

## 🚢 Deployment

### GitHub Container Registry (Automatic)

Push to `main` branch or create a tag to automatically build and publish:

```bash
git tag v1.0.0
git push origin v1.0.0
```

### Manual Deployment

```bash
# Build multi-arch image
docker buildx build --platform linux/amd64,linux/arm64 -t your-registry/mcp-server .

# Push to registry
docker push your-registry/mcp-server
```

## 🔒 Security

- Runs as non-root user
- HTTP server binds to localhost by default
- Protocol version validation
- Input sanitization

## 📄 License

MIT License - see LICENSE file for details.

---

**🎯 Ready to build your MCP server?** Click "Use this template" to get started!

## Source & license

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

- **Author:** [Philip-Walsh](https://github.com/Philip-Walsh)
- **Source:** [Philip-Walsh/mcp](https://github.com/Philip-Walsh/mcp)
- **License:** MIT

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:** yes
- **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-philip-walsh-mcp
- Seller: https://agentstack.voostack.com/s/philip-walsh
- 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%.