Talebook MCP Server

A simple Model Context Protocol (MCP) server built with FastAPI that provides book-related tools.

Features

• get_books_count: Returns the current count of books in the collection (defaults to 1)

• Built with FastAPI for both MCP and HTTP interfaces

• Supports both stdio transport (for MCP clients) and HTTP endpoints

Installation

1. Install dependencies:

Usage

Running as MCP Server (stdio transport)

Running as FastAPI HTTP Server

The HTTP server will be available at http://localhost:8000

Available Endpoints (HTTP mode)

• GET / - Health check

• GET /tools - List available tools

• POST /tools/get_books_count - Get books count

Available Tools (MCP mode)

• get_books_count: Get the current count of books in the collection

  • Input: No parameters required

  • Output: Text content with the books count

MCP Configuration

To use this server with an MCP client, add the following to your MCP configuration:

Development

The server is structured to be easily extensible. To add new tools:

1. Add the tool definition to the list_tools() function

2. Add the tool handler to the call_tool() function

3. Implement the tool function

4. Optionally add HTTP endpoints for the new tool

Example Tool Usage

When using an MCP client, you can call the get_books_count tool:

The server will respond with: