bc_resource_mcp/README.md

MCP server for Baichuan resource

# 百川资源 MCP 服务

## 项目介绍

百川资源 MCP (Model Context Protocol) 服务是一个基于 MCP 协议的服务端应用，用于获取和处理百川教育资源平台的音频资源。该服务支持两种运行模式：

- **STDIO 模式**：通过标准输入输出与客户端通信
- **SSE 模式**：通过 Server-Sent Events 与客户端通信

## 功能特性

- 支持查询教育资源图书列表
- 支持查询图书章节列表
- 支持获取音频资源详情
- 支持通过 MCP 协议与大模型交互
- 支持多种运行模式（STDIO/SSE）

## 技术栈

- TypeScript
- Express.js
- MCP SDK (@modelcontextprotocol/sdk)

## 安装

### 前置条件

- Node.js >= 16.0.0
- npm

### 安装步骤

1. 克隆仓库

```bash
git clone <仓库地址>
cd bc_resource_mcp
```

2. 安装依赖

```bash
npm install
```

3. 构建项目

```bash
npm run build
```

## 使用方法

### 开发模式

#### STDIO:

```bash
npm build
```

然后使用客户端或者 MCP Inspector 进行测试

```bash
npx @modelcontextprotocol/inspector node dist/index.js
```

### SSE 模式

```bash
npm run dev:sse
```

然后使用支持 SSE 的客户端测试
配置文件

```json
{
  "mcpServers": {
    "bc_resource_mcp": {
    "url": "http://localhost:8083/sse"
      "headers": {
        "MODULE_ID": "1805539756174397441"
      }
    }
  }
}
```

### 生产模式

#### STDIO:

```json
{
  "mcpServers": {
    "bc_resource_mcp": {
      "command": "npx",
      "args": ["bc_resource_mcp"],
      "env": {
        "MODULE_ID": "1805539756174397441"
      }
    }
  }
}
```

#### SSE:

```json
{
  "mcpServers": {
    "bc_resource_mcp": {
    "url": "http://localhost:8083/sse"
      "headers": {
        "MODULE_ID": "1805539756174397441"
      }
    }
  }
}
```