内容
rinth MCP
[](https://www.npmjs.com/package/@iafenvoy/modrinth-mcp)
[](LICENSE)
一个遵循 [模型上下文协议（Model Context Protocol，MCP）](https://modelcontextprotocol.io/) 的服务器，暴露了 [Modrinth API](https://docs.modrinth.com/api/)。通过 GitHub Copilot、Claude Desktop 或任何兼容 MCP 的客户端，直接查询 Minecraft 模组、插件、模组包、着色器、资源包等。
## 功能特点
- **22 个只读工具**，涵盖搜索、项目、版本、版本文件、用户、团队和标签
- **无需身份验证** — 零配置开箱即用
- **零配置标准输出传输** — 通过标准输入/输出工作，无需 HTTP 服务器
## 可用工具
### 搜索
| 工具 | 描述 |
|------|-------------|
| `search_projects` | 带有筛选、排序和分页的全文本搜索 |
| `search_projects_v3` | 通过 v3 API 搜索（支持 `loader_fields`） |
### 项目
| 工具 | 描述 |
|------|-------------|
| `get_project` | 按 ID 或 slug 获取项目 |
| `get_projects` | 一次获取多个项目 |
| `get_random_projects` | 发现随机项目 |
| `check_project_slug` | 验证项目 ID 或 slug |
| `get_project_dependencies` | 列出项目的依赖项 |
### 版本
| 工具 | 描述 |
|------|-------------|
| `get_project_versions` | 列出项目的所有版本 |
| `get_version` | 按 ID 获取单个版本 |
| `get_versions` | 按 ID 获取多个版本 |
### 版本文件
| 工具 | 描述 |
|------|-------------|
| `get_version_file` | 按 SHA-1 / SHA-512 哈希查找版本文件 |
| `get_version_files_by_hashes` | 按哈希批量查找版本文件 |
### 用户和团队
| 工具 | 描述 |
|------|-------------|
| `get_user` | 按 ID 或用户名获取用户 |
| `get_users` | 一次获取多个用户 |
| `get_user_projects` | 列出用户拥有的项目 |
| `get_project_team_members` | 列出项目的团队成员 |
| `get_team_members` | 按团队 ID 列出团队成员 |
### 标签和元数据
| 工具 | 描述 |
|------|-------------|
| `get_categories` | 列出所有项目类别 |
| `get_loaders` | 列出所有模组加载器（Fabric、Forge 等） |
| `get_game_versions` | 列出所有 Minecraft 游戏版本 |
| `get_licenses` | 列出所有可用的许可证 |
| `get_license_text` | 按 ID 获取许可证全文 |
| `get_donation_platforms` | 列出捐赠平台 |
| `get_report_types` | 列出报告类型 |
| `get_project_types` | 列出项目类型（模组、模组包、着色器等） |
| `get_side_types` | 列出客户端/服务器端类型 |
| `get_statistics` | Modrinth 全局统计数据 |
## 安装
```bash
npm install @iafenvoy/modrinth-mcp
```
## 使用
### VS Code / GitHub Copilot
添加到您的 `.vscode/mcp.json`：
```json
{
"servers": {
"modrinth": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@iafenvoy/modrinth-mcp"]
}
}
}
```
### Claude Desktop
添加到 `claude_desktop_config.json`：
```json
{
"mcpServers": {
"modrinth": {
"command": "npx",
"args": ["-y", "@iafenvoy/modrinth-mcp"]
}
}
}
```
### 本地开发
```bash
git clone https://github.com/IAFEnvoy/modrinth-mcp.git
cd modrinth-mcp
npm install
npm run build
node dist/index.js
```
## API 速率限制
th 允许 **每分钟 300 次请求**，每个 IP 地址的速率限制相同，无论是否使用身份验证令牌。
## API 注意事项
- 默认使用 **Modrinth API v2** (`https://api.modrinth.com/v2`)；v3 搜索端点也通过 `search_projects_v3` 提供。
- 所有请求都包含 [Modrinth 要求的](https://docs.modrinth.com/api/#user-agents) 适当的 `User-Agent` 头。
- 项目和版本 ID 是 8 个字符的 base62 字符串。
## 项目结构
```
src/
├── index.ts # MCP 服务器入口点
├── config.ts # 常量
├── api-client.ts # 带有错误处理的 HTTP 客户端
├── tools.ts # 工具定义（22 个工具）
└── handlers.ts # 工具调用路由
```
## 许可证
[MIT](LICENSE)
