Talebook

MCP Server for talebook

python

1

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "horkychen-talebook-mcp": {
      "command": "python",
      "args": [
        "/path/to/talebook-mcp/src/server.py"
      ],
      "env": {
        "ENV": "PLACEHOLDER"
      }
    }
  }
}

You run Talebook MCP Server to expose book-related tools via both an MCP-friendly stdio transport and an HTTP interface. This makes it easy to query the current number of books in the collection from an MCP client or to inspect and use the HTTP endpoints for quick checks and tool access.

How to use

You can operate the Talebook MCP Server in two modes: as an MCP-compatible stdio service or as a FastAPI HTTP server. In MCP mode, you start the local Python script so clients can invoke tools through the MCP protocol. In HTTP mode, you run the same server with an HTTP interface and interact with the exposed endpoints.

How to use with MCP clients

Start the server in MCP mode to enable stdio-based tool calls. Run the following command in your project directory to launch the MCP service locally:

python src/server.py

How to use with HTTP clients

Start the HTTP server to expose the API over HTTP. Run this command to enable the FastAPI HTTP interface on localhost port 8000:

python src/server.py --fastapi

What you can do once the server is running

MCP mode lets you call the available tools directly through the MCP protocol. The primary tool is get_books_count, which returns the current number of books in the collection. Implementations are designed so you do not need to supply any parameters for this tool.

In HTTP mode, you can quickly check the system and access the tool via HTTP endpoints. The health check is available at the root path, the tools list at /tools, and the get_books_count tool can be invoked via a POST on /tools/get_books_count.

How to configure an MCP client to run this server

If you want an MCP client to connect to this server, include an MCP configuration that starts the server via a Python command and points to the server script. Use the following example as a reference for your MCP config.

{
  "mcpServers": {
    "talebook_mcp": {
      "command": "python",
      "args": ["/path/to/talebook-mcp/src/server.py"],
      "env": {}
    }
  }
}

Notes on availability and endpoints

The server exposes a simple health check at the HTTP root and a tools endpoint set when running in HTTP mode. The MCP mode exposes the get_books_count tool. For MCP usage, there are no required parameters for this tool; you simply request the current books count.

Configuration and security

Configure and run the server according to the mode you choose. If you run in HTTP mode, ensure the server is accessible at the expected host and port (default is http://localhost:8000). Keep the server behind appropriate network boundaries if used in production, and limit access to protect underlying data.

Development notes

The server is structured to be easily extensible. To add new tools, extend the tool list and implement corresponding handlers in the server code, and optionally expose new HTTP endpoints for the tools.

Available tools

get_books_count

Returns the current count of books in the collection. No input parameters are required; the output is a text value with the count.