mcp-google-books

mcp-google-books

1
research_and_data

MCP Google Books is a server that interfaces with the Google Books API to provide book information. It is intended for use in environments that support the MCP protocol, offering search functionalities by book title and author, and returning detailed book data.

MCP Google Books

smithery badge

🧐 What is This?

This MCP server package exposes functionality for fetching book related information from Google Books API. This implementation is designed to be used in environments that support the MCP protocol, such as Claude.

📦 Usage

Installing via Smithery

To install mcp-google-books for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @juanbeniteza/mcp-google-books --client claude

Starting Up the Server

To begin using mcp-google-books, connect to your MCP compatible environment (such as Claude) and then run the server.

  1. Start the server by issuing the following command: 
    node mcp-google-books.js

💡 Example

Below is a detailed example of how to use the mcp-google-books server with an MCP compatible client:

  1. Initialize the Server

    • Start the server.

  2. Client Interactions

    • With a running instance of Claude or another compatible client, the client should automatically connect and discover this server, listing its tools and resources available for use.
    • You can query books by title or author.

  3. Tool Listings

    • Once the server initializes, list available tools. This would include actions that can be invoked by clients.

  4. Calling Tools

    • Clients can now call available tools for getting book information via Google Books API.

🙏 Acknowledgements

Special thanks to Google Books API for providing the required data.

🌍 License

This repository is licensed under the MIT License. See the LICENSE file for more information.

🛠️ Available Tools

This MCP server provides the following tools for interacting with Google Books:

1. Book Search

Search for books by title using the Google Books API.

mcp_Google_Books_book_search(query: str)

Parameters:

  • query: The title of the book to search for

Example:

# Search for a book by title
result = mcp_Google_Books_book_search(query="The Hobbit")

2. Author Search

Search for books by author using the Google Books API.

mcp_Google_Books_author_search(query: str)

Parameters:

  • query: The name of the author to search for

Example:

# Search for books by an author
result = mcp_Google_Books_author_search(query="J.R.R. Tolkien")

📝 Response Format

Both tools return information about books including:

  • Title
  • Author(s)
  • Published Date
  • Description (when available)

The results are returned in a formatted text that can be easily read and processed by MCP clients.

⚠️ Rate Limiting

Please note that these tools use the Google Books API, which has rate limiting. Make sure to handle your requests accordingly to avoid hitting API limits.