vineetkothari23/blog-mcp-server-client

    # README.md
    readme_template = '''# blog

API for managing blog posts, including comments and user interactions

Generated by mcp-cli - A tool for creating MCP (Model Context Protocol) servers.

🚀 Features

• MCP Protocol Compliance: Full support for Model Context Protocol
• Async Operations: Built with asyncio for high performance
• Type Safety: Complete type hints with Pydantic validation
• Testing: Complete test suite with pytest
• Docker Ready: Containerization included

📦 Installation

From Source

git clone <repository-url>
cd blog
pip install -e .

Development Installation

git clone <repository-url>
cd blog
pip install -e ".[dev]"

⚙️ Configuration

Create a .env file based on .env.example:

cp .env.example .env
# Edit .env with your configuration

🎯 Usage

Starting the Server

# Using the CLI command
blog-server

# Or using Python module
python -m mcp_blog.server

# Or using the script
python scripts/run_server.py

🧪 Testing

# Run all tests
python -m pytest

# Run with coverage
python -m pytest --cov=src --cov-report=html

# Run specific tests
python -m pytest tests/unit/

🐳 Docker Deployment

# Build and run
docker build -t blog .
docker run -p 8080:8080 --env-file .env blog

# Or use docker-compose
docker-compose up

📚 API Documentation

Available Tools

🐛 Troubleshooting

Common Issues

"Module not found" errors

pip install -e .

"Connection refused" errors

# Check API endpoint
curl $MCP_API_BASE_URL/health

📄 License

This project is licensed under the MIT License.

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Make your changes with tests
4. Run the test suite
5. Submit a pull request