MCP Blog API

# MCP Blog API A simple blog API service built with FastMCP and httpx. This project supports uv for fast, reliable Python package management and environment setup. ## Description This project provides a set of API tools to interact with a mock blog API service. It allows users to fetch all blogs, search for blogs by title, and add new blog posts. The project includes a uv.lock file for reproducible dependency management. ## Features - Fetch all blogs from the mock API - Search for blogs by title - Add new blog posts ## Requirements - Python 3.13 or higher - httpx 0.28.1 or higher - mcp 1.9.0 or higher ## Installation ### Using uv (Recommended) ```bash # Clone the repository git clone https://github.com/yourusername/mcp-blog.git cd mcp-blog # Install dependencies with uv uv pip install -e . ``` ### Using pip ```bash # Clone the repository git clone https://github.com/yourusername/mcp-blog.git cd mcp-blog # Install dependencies pip install -e . ``` ## Usage ```python # Import the MCP server from main import mcp # Get all blogs blogs = mcp.tools.get_blogs() # Search for blogs by title search_results = mcp.tools.search_blogs(query="Python") # Add a new blog new_blog = mcp.tools.add_blog(title="My New Blog", body="This is the content of my new blog post.") ``` ## Running the Server ### Using uv (Recommended) ```bash uv python main.py ``` ### Using standard Python ```bash python main.py ``` ## Environment Management ### Using uv (Recommended) uv provides fast environment management for Python projects. Here's how to create and manage a virtual environment for this project: ```bash # Create a new virtual environment uv venv # Activate the virtual environment # On Unix/macOS source .venv/bin/activate # On Windows .venv\Scripts\activate # Install dependencies in the virtual environment uv pip install -e . # Update dependencies uv pip sync ``` ## API Reference ### get_blogs() Fetches all blogs from the mock API. ### search_blogs(query: str) Searches for blogs by title using the mock API. ### add_blog(title: str, body: str) Adds a new blog to the mock API. ## License [Add your license information here] ## Contributing [Add contribution guidelines here]