open-index/open-npm huggingface dataset:
npm package: @mseep/microcms-api-mcp-server
Description: MCP サーバで microCMS API を利用可能にする
Author: burnworks
Latest version: 1.0.0

# microCMS MCP サーバ

このプロジェクトは、[Model Context Protocol (MCP)](https://modelcontextprotocol.io) を使用して microCMS の API にアクセスするサーバを実装したものです。

## 概要

microCMS MCP サーバは以下の機能を提供します：

1. **コンテンツ一覧取得**：指定したエンドポイントからコンテンツ一覧を取得
2. **特定コンテンツ取得**：ID を指定して特定のコンテンツを取得
3. **コンテンツ検索**：キーワード検索によるコンテンツの取得
4. **フィルター検索**：複雑な条件でのコンテンツのフィルタリング

## インストール

```bash
# リポジトリのクローン
git clone https://github.com/burnworks/microcms-api-mcp-server
cd microcms-api-mcp-server

# 依存関係のインストール
npm install
```

## 使用方法

### 必要なファイルのビルド

```bash
# TypeScriptをコンパイル
npm run build
```

`dist/` ディレクトリ内に必要なファイルが生成されます。

### MCP クライアントからの使用

このサーバは MCP プロトコルに準拠しており、任意の MCP クライアントから接続して使用できます。

#### Claude デスクトップアプリでの利用

`claude_desktop_config.json` に下記のように設定してください。

```json
{
  "mcpServers": {
    "microcms": {
      "command": "node",
      "args": [
        "/[__path__]/microcms-api-mcp-server/dist/index.js"
      ],
      "env": {
        "MICROCMS_API_KEY": "__your_api_key_here__",
        "MICROCMS_BASE_URL": "https://your-service.microcms.io"
      }
    }
  }
}
```

Windows 環境であれば下記のような設定になるかもしれません。

```json
{
  "mcpServers": {
    "microcms": {
      "command": "C:/Program Files/nodejs/node.exe",
      "args": [
        "C:/[__path__]/microcms-api-mcp-server/dist/index.js"
      ],
      "env": {
        "MICROCMS_API_KEY": "__your_api_key_here__",
        "MICROCMS_BASE_URL": "https://your-service.microcms.io"
      }
    }
  }
}
```

## 利用可能なツール

例えば下記のようなプロンプトで microCMS API にアクセスできます。

```
blog エンドポイントから、最新の記事10件分のタイトルを取得して
```

### `get_contents`

コンテンツ一覧を取得します。

**パラメータ**:
- `endpoint`: 取得したい microCMS の API エンドポイント（例: 'blog'）
- `limit`: 取得する件数（オプション、デフォルト: 10、最大: 100）
- `offset`: 取得開始位置のオフセット（オプション）
- `orders`: 並び替え（オプション、例: 'publishedAt' または '-publishedAt'）
- `q`: 全文検索クエリ（オプション）
- `filters`: フィルタ条件（オプション、例: 'title[contains]テスト'）
- `fields`: 取得フィールド（オプション、例: 'id,title,publishedAt'）
- `depth`: 参照の深さ（オプション、1-3）

### `get_content`

特定のコンテンツを取得します。

**パラメータ**:
- `endpoint`: 取得したい microCMS の API エンドポイント（例: 'blog'）
- `contentId`: 取得したいコンテンツの ID
- `fields`: 取得フィールド（オプション、例: 'id,title,publishedAt'）
- `depth`: 参照の深さ（オプション、1-3）
- `draftKey`: 下書きコンテンツを取得するためのキー（オプション）

### `search_contents`

キーワード検索でコンテンツを取得します。

**パラメータ**:
- `endpoint`: 検索対象の microCMS の API エンドポイント（例: 'blog'）
- `q`: 検索キーワード
- `limit`: 取得する件数（オプション、デフォルト: 10、最大: 100）
- `offset`: 取得開始位置のオフセット（オプション）
- `fields`: 取得フィールド（オプション、例: 'id,title,publishedAt'）
- `depth`: 参照の深さ（オプション、1-3）

### `filter_contents`

複雑な条件でコンテンツをフィルタリングします。

**パラメータ**:
- `endpoint`: 検索対象の microCMS の API エンドポイント（例: 'blog'）
- `filters`: フィルター条件（例: 'category[equals]news[and]createdAt[greater_than]2023-01-01'）
- `limit`: 取得する件数（オプション、デフォルト: 10、最大: 100）
- `offset`: 取得開始位置のオフセット（オプション）
- `fields`: 取得フィールド（オプション、例: 'id,title,publishedAt'）
- `depth`: 参照の深さ（オプション、1-3）

## 利用可能なリソース

### `microcms://{endpoint}/{contentId}`

特定の ID のコンテンツを取得するためのリソース URI テンプレート。

### `microcms://{endpoint}`

コンテンツ一覧を取得するためのリソース URI テンプレート。

## ライセンス

MIT
npm package: @mseep/midi-file-mcp
Description: A MCP tool for parsing and manipulating MIDI files based on Tone.js
Author: xiaolaa2
Latest version: 0.1.3

# 🎵 MIDI文件MCP

<div align="center">
  
![许可证](https://img.shields.io/badge/许可证-MIT-green)
[![tonejs](https://img.shields.io/badge/tonejs-midi-orange)](https://github.com/Tonejs/Midi)
[![MCP](https://img.shields.io/badge/MCP-ModelContextProtocol-purple)](https://modelcontextprotocol.ai/)

</div>

<div align="center">
  <strong>基于Tone.js和MCP协议的MIDI文件解析与操作工具</strong>
</div>

<br>

---

## 📖 简介

这是一个基于Tone.js和@tonejs/midi库的MIDI文件解析和操作工具，通过MCP(Model Context Protocol)服务提供功能。这个工具使您能够轻松读取、分析和修改MIDI文件，无需深入了解MIDI文件格式的复杂性。

## ✨ 功能特点

- 读取MIDI文件信息
- 获取和修改MIDI文件的轨道、音符、控制器变化和弯音信息
- 设置MIDI文件的速度(BPM)
- 向特定轨道添加新的音符、控制器变化和弯音信息
- 添加新的轨道

## 📥 安装准备
1. 安装 **Node.js**：确保 npx 命令可以正常运行，建议前往 [Node.js 官网](https://nodejs.org/) 安装最新的稳定版本

## 🔧 使用方法
使用 MCP 客户端连接，支持的客户端包括但不限于：
   - [Cursor](https://www.cursor.com)
   - [Cherry Studio](https://github.com/CherryHQ/cherry-studio)
   - Claude Desktop

### Cursor 配置示例

在 Cursor 中配置 midi-file-mcp：

```json
"midi-file-mcp": {
    "command": "npx",
    "args": [
        "-y",
        "midi-file-mcp"
    ]
}
```

### 🎹 使用绝对路径操作MIDI文件

MIDI Parser MCP的所有操作都需要提供MIDI文件的绝对路径。这确保了无论当前工作目录是什么，工具都能正确定位和操作您的MIDI文件。

#### 示例提示

以下是一些您可以与AI助手一起使用的示例提示：

1. **获取MIDI文件信息**：
   ```
   请显示D:\path\to\your\file.mid文件的信息。
   ```

2. **分析轨道**：
   ```
   请分析D:\path\to\your\file.mid中的所有轨道，并告诉我每个轨道有多少个音符。
   ```

3. **设置速度**：
   ```
   将D:\path\to\your\file.mid的速度更改为120 BPM。
   ```

4. **处理音符**：
   ```
   显示D:\path\to\your\file.mid中轨道1的所有音符。
   ```

5. **添加音符**：
   ```
   在D:\path\to\your\file.mid的轨道0的位置0添加一个持续时间为1拍的C4音符。
   ```

#### 可用操作

| 操作 | 描述 | 参数 |
|-----------|-------------|------------|
| get_midi_info | 获取MIDI文件基本信息 | filePath |
| set_tempo | 设置MIDI文件的速度(BPM) | filePath, bpm |
| get_tracks_info | 获取所有轨道的信息 | filePath |
| get_track_info_by_index | 获取特定轨道的信息 | filePath, trackIndex |
| get_notes_by_index | 获取特定轨道的所有音符 | filePath, trackIndex |
| get_pitchbends_by_index | 获取特定轨道的所有弯音 | filePath, trackIndex |
| get_controlchanges_by_index | 获取特定轨道的所有控制器变化 | filePath, trackIndex |
| add_notes_by_index | 向特定轨道添加音符 | filePath, trackIndex, notes |
| add_controlchanges_by_index | 向特定轨道添加控制器变化 | filePath, trackIndex, controlchanges |
| add_pitchbends_by_index | 向特定轨道添加弯音 | filePath, trackIndex, pitchbends |
| add_track | 向MIDI文件添加新轨道 | filePath |

**注意**：在Windows系统下使用路径时，请始终使用双反斜杠(`\\`)或正斜杠(`/`)以避免错误。

## 📄 许可证

本项目采用MIT许可证。详情请参阅LICENSE文件。

## 🙏 致谢

感谢以下项目和库，没有它们这个工具将无法实现：
- [Tone.js](https://tonejs.github.io/) - Web音频框架
- [@tonejs/midi](https://github.com/Tonejs/Midi) - MIDI文件解析和操作库
- [MCP (Model Context Protocol)](https://modelcontextprotocol.ai/) - 使工具集成到AI助手成为可能