MCP博客项目

本项目演示了模型上下文协议 (MCP) 在博客应用程序系统中的实现。它由三个主要组件组成，这些组件协同工作，以提供语言模型和结构化数据操作之间的无缝集成。

项目结构

.
├── books-mcp-server/     # TypeScript MCP 服务器实现
│   ├── build/           # 编译后的 JavaScript 文件
│   ├── src/             # 源代码 TypeScript 文件
│   └── package.json     # 服务器依赖项和脚本
├── books-mock-service/  # 书籍数据的模拟服务
│   └── server.js        # Express.js 模拟服务器
└── mcp-client/         # Python MCP 客户端实现
    └── client.py       # 主客户端应用程序

组件

1. Books MCP 服务器

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

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

2. Books 模拟服务

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

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

3. MCP 客户端

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

• 使用 langchain_ollama 进行 LLM 集成
• 实现 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
# 创建并激活虚拟环境 (推荐)
python -m venv .venv
source .venv/bin/activate  # 在 Windows 上: .venv\Scripts\activate
# 安装依赖项 (需要 requirements.txt)
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 中的 LLM 配置来自定义客户端

依赖项

• Node.js 和 npm 用于 MCP 服务器和模拟服务
• Python 3.x 用于客户端
• Ollama 用于本地 LLM 支持
• package.json 文件中指定的各种 npm 包
• Python 包：langchain-ollama, mcp-use