MCP Books Service

This project demonstrates the implementation of the Model Context Protocol (MCP) in a blog application system, including a TypeScript MCP server, a simulated book service, and a Python client, enabling seamless integration of language models and structured data operations.

Developer tools Artificial intelligence chatbots #Protocol implementation #Data integration #Blog system .Python

rating : 2 points

downloads : 17

update time : 2025-04-29

What is the Books MCP Server?

The Books MCP Server is a middleware service that implements the Model Context Protocol (MCP) to facilitate secure and reliable communication between language models (such as AI assistants) and backend data services (such as book databases).

How to use the Books MCP Server?

You can interact with the server through a Python client, send natural language queries, and the server will convert them into structured requests and return formatted responses.

Use cases

Suitable for applications that need to combine AI language capabilities with structured data, such as intelligent book query systems and content management systems.

Main features

Protocol conversionConvert natural language queries into structured API requests

Secure communicationEnsure data transmission security through the standardized MCP protocol

Type safetyDeveloped using TypeScript to ensure type safety

Advantages and limitations

Advantages

Simplify the integration of AI and backend systems

Provide a standardized communication protocol

Support multiple language clients

Limitations

Require additional deployment of middleware services

May increase complexity for small projects

How to use

Install dependencies

Ensure that Node.js and npm are installed

Start the server

Navigate to the project directory and start the MCP server

Start the client

Start the Python client in another terminal

Usage examples

Query books by a specific authorFind all works by a certain author

Filter books by categoryFind books in a specific category

Frequently Asked Questions

What software needs to be installed to run it?

How to extend support for new data services?

Does it support clients in other languages?

Related resources

MCP Protocol Documentation

Official MCP protocol specification documentation

GitHub Repository

Project source code

TypeScript Handbook

Official TypeScript documentation

🚀 MCP Implementation in Blog Project

This project demonstrates the implementation of the Model Context Protocol (MCP) in a blog application system. It consists of three main components that work together to provide seamless integration between language models and structured data operations.

🚀 Quick Start

This project showcases the implementation of MCP in a blog application system. It integrates language models with structured data operations through three key components.

✨ Features

Seamless Integration: Enables smooth interaction between language models and structured data operations.
Multi - language Support: Utilizes TypeScript for the server and Python for the client, offering flexibility.
Mock Service: Provides a simple mock service for easy testing and development.

📦 Installation

1. Books MCP Server Installation

cd books-mcp-server
npm install
npm run build

2. Books Mock Service Installation

cd books-mock-service
npm install
npm run dev

3. MCP Client Installation

cd mcp-client
# Create and activate a virtual environment (recommended)
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate
# Install dependencies (requires requirements.txt file)
pip install langchain-ollama mcp-use

💻 Usage Examples

Basic Usage

Run the mock service:

cd books-mock-service
npm run dev

Run the client in a new terminal:

cd mcp-client
python client.py

Enter the prompted query. Type 'exit' to quit.

📚 Documentation

Project Structure

.
├── books-mcp-server/     # TypeScript-based MCP server implementation
│   ├── build/           # Compiled JavaScript files
│   ├── src/             # Source TypeScript files
│   └── package.json     # Server dependencies and scripts
├── books-mock-service/  # Book data mock service
│   └── server.js        # Express.js mock server
└── mcp-client/         # Python-based MCP client implementation
    └── client.py       # Main client application

Components

1. Books MCP Server

A TypeScript-based MCP server responsible for handling the communication protocol between the client and the mock service.

Built with TypeScript for type safety.
Implements MCP using @modelcontextprotocol/sdk.
Runs on the stdio transport layer.

2. Books Mock Service

A simple Express.js server that simulates a book data service.

Provides mock endpoints for book-related operations.
Built with Express.js.
Lightweight and easy to extend.

3. MCP Client

A Python-based client that integrates with the language model using the MCP protocol.

Integrates with LLM using langchain_ollama.
Implements MCPAgent to handle queries.
Provides an interactive CLI interface.

🔧 Technical Details

The MCP server is built with TypeScript. After making changes in the src directory, use npm run build to rebuild.
The mock service can be extended by adding new routes to server.js.
The client's LLM configuration in client.py can be modified as needed.