Micro.blog Books MCP Server

# Micro.blog Books MCP Server An MCP (Model Context Protocol) server built with FastMCP that provides access to the Micro.blog Books API. Deployed on [fastmcp.cloud](https://fastmcp.cloud) for easy integration with Claude Desktop and other MCP clients. ## Features This MCP server provides the following tools for managing your Micro.blog books: ### Bookshelf Management - **get_bookshelves**: Get all your bookshelves - **get_bookshelf_books**: Get books in a specific bookshelf - **add_bookshelf**: Create a new bookshelf - **rename_bookshelf**: Rename an existing bookshelf ### Book Management - **add_book**: Add a new book to a bookshelf - **move_book**: Move a book between bookshelves - **remove_book**: Remove a book from a bookshelf - **change_book_cover**: Update a book's cover image ### Reading Goals - **get_reading_goals**: Get your reading goals - **get_goal_progress**: Get progress toward a specific reading goal - **update_reading_goal**: Update a reading goal's target or progress ## Deployment This server is designed to be deployed on [fastmcp.cloud](https://fastmcp.cloud). ### Prerequisites - A [Micro.blog](https://micro.blog) account with API access - A bearer token from your Micro.blog account settings ### Environment Variables Set the following environment variable in your fastmcp.cloud deployment: | Variable | Description | Required | |----------|-------------|----------| | `MICRO_BLOG_BEARER_TOKEN` | Your Micro.blog API bearer token | Yes | ### Deploy to fastmcp.cloud 1. Connect your GitHub repository to fastmcp.cloud 2. Set the `MICRO_BLOG_BEARER_TOKEN` environment variable in the fastmcp.cloud dashboard 3. Deploy - the server will be available at your fastmcp.cloud endpoint ### Local Development For local testing: ```bash # Install dependencies uv sync # Run the server locally export MICRO_BLOG_BEARER_TOKEN="your_token_here" uv run fastmcp run server.py --transport http --port 8000 # Or run directly uv run python server.py ``` ## Usage Once deployed, you can connect to the server from Claude Desktop or any MCP client using the HTTP transport. Example prompts: - "Show me all my bookshelves" - "Add 'Project Hail Mary' by Andy Weir to my Currently Reading bookshelf" - "What are my reading goals for this year?" - "Move book ID 79 to bookshelf ID 23" ## API Reference All tools return JSON responses from the Micro.blog API. The server handles authentication automatically using your bearer token. For more details about the underlying API, see the [Micro.blog Books API documentation](https://help.micro.blog/t/books-api/280). ## License This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.