MCP Blog Project

MCP 博客项目

本项目展示了如何在博客应用系统中实现 Model Context Protocol (MCP)。项目由三个主要组件组成，它们协同工作，让大模型与结构化数据操作实现无缝集成。

项目结构

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

组件

1. Books MCP 服务

一个基于 TypeScript 的 MCP 服务，负责处理客户端与模拟服务之间的通信协议。

• 使用 TypeScript 构建，确保类型安全
• 使用 @modelcontextprotocol/sdk 实现 MCP
• 使用 stdio 传输层运行

2. Books 模拟服务

一个简单的 Express.js 服务，用于模拟图书数据服务。

• 提供图书相关操作的模拟端点
• 使用 Express.js 构建
• 轻量且易于扩展

3. MCP 客户端

一个基于 Python 的客户端，使用 MCP 协议与大模型集成。

• 使用 langchain_ollama 集成大模型
• 实现 MCPAgent 来处理查询
• 提供交互式 CLI 界面

设置说明

1. Books MCP 服务设置

cd books-mcp-server
npm install
npm run build

2. Books 模拟服务设置

cd books-mock-service
npm install
npm run dev

3. MCP 客户端设置

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

使用方法

1. 启动模拟服务：

cd books-mock-service
npm run dev

2. 在新的终端中运行客户端：

cd mcp-client
python client.py

3. 按提示输入查询。输入 'exit' 退出。

开发

• MCP 服务使用 TypeScript 构建。在 src 目录中进行修改，并使用 npm run build 重新构建
• 可通过在 server.js 中添加新路由来扩展模拟服务
• 可通过修改 client.py 中的大模型配置来自定义客户端

依赖项

• MCP 服务和模拟服务需要 Node.js 和 npm
• 客户端需要 Python 3.x
• 本地大模型支持需要 Ollama
• package.json 文件中指定的各种 npm 包
• Python 包：langchain-ollama、mcp-use