# MCP Server for Qiita

Qiita API v2用のMCP（Model Context Protocol）サーバーです。日本ユーザー向けに日本語のコメントとドキュメントを提供します。

## 機能

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

### ユーザー関連
- 認証されたユーザー情報の取得
- ユーザー詳細情報の取得
- ユーザー一覧の取得
- ユーザーの記事一覧の取得
- ユーザーのストック一覧の取得
- ユーザーのフォロワー・フォロー一覧の取得
- ユーザーのフォロー・フォロー解除

### 記事関連
- 記事一覧の取得（検索機能付き）
- 記事詳細情報の取得
- 記事の作成・更新・削除
- 記事のストック・ストック解除
- 記事のストック状況確認
- 記事のストッカー一覧取得

### タグ関連
- タグ一覧の取得（ソート機能付き）
- タグ詳細情報の取得
- タグの記事一覧の取得
- タグのフォロー・フォロー解除
- タグのフォロー状況確認

### コメント関連
- 記事のコメント一覧の取得
- コメントの作成・更新・削除
- コメント詳細情報の取得

## インストール

### 前提条件
- Node.js 18.0.0以上

### NPMからインストール（推奨）

```bash
npm install -g mcp-server-qiita
```

### 開発版のセットアップ

1. リポジトリをクローン
```bash
git clone https://github.com/selenium39/mcp-server-qiita.git
cd mcp-server-qiita
```

2. 依存関係をインストール
```bash
npm install
```

3. ビルド
```bash
npm run build
```

## 使用方法

### 環境変数の設定

Qiita APIを使用するには、アクセストークンが必要です。以下の環境変数を設定してください：

```bash
export QIITA_ACCESS_TOKEN="your_qiita_access_token_here"
```

アクセストークンは[Qiitaのトークン設定ページ](https://qiita.com/settings/tokens/new)で生成できます。

### サーバーの起動

```bash
pnpm start
```

または開発モードで起動：

```bash
pnpm dev
```

### MCPクライアントでの使用

このサーバーはMCPプロトコルを使用してクライアントと通信します。

#### Cursor設定例 (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "qiita": {
      "command": "mcp-server-qiita",
      "env": {
        "QIITA_ACCESS_TOKEN": "your_qiita_access_token_here"
      }
    }
  }
}
```

#### 利用可能なツール

以下のようなツールが利用可能です：

#### ユーザー関連ツール
- `get_authenticated_user`: 認証されたユーザー情報を取得
- `get_user`: 指定されたユーザーの詳細情報を取得
- `get_users`: ユーザー一覧を取得
- `get_user_items`: 指定されたユーザーの記事一覧を取得
- `get_user_stocks`: 指定されたユーザーのストック一覧を取得
- `get_user_followers`: 指定されたユーザーのフォロワー一覧を取得
- `get_user_followees`: 指定されたユーザーのフォロー一覧を取得
- `follow_user`: 指定されたユーザーをフォロー
- `unfollow_user`: 指定されたユーザーのフォローを解除
- `is_user_followed`: 指定されたユーザーをフォローしているかどうかを確認

#### 記事関連ツール
- `get_items`: 記事一覧を取得（検索機能付き）
- `get_item`: 指定された記事の詳細情報を取得
- `create_item`: 新しい記事を作成
- `update_item`: 既存の記事を更新
- `delete_item`: 指定された記事を削除
- `stock_item`: 指定された記事をストック
- `unstock_item`: 指定された記事のストックを解除
- `is_item_stocked`: 指定された記事がストックされているかどうかを確認
- `get_item_stockers`: 指定された記事をストックしたユーザー一覧を取得

#### タグ関連ツール
- `get_tags`: タグ一覧を取得（ソート機能付き）
- `get_tag`: 指定されたタグの詳細情報を取得
- `get_tag_items`: 指定されたタグの記事一覧を取得
- `follow_tag`: 指定されたタグをフォロー
- `unfollow_tag`: 指定されたタグのフォローを解除
- `is_tag_followed`: 指定されたタグをフォローしているかどうかを確認

#### コメント関連ツール
- `get_item_comments`: 指定された記事のコメント一覧を取得
- `create_comment`: 指定された記事にコメントを作成
- `update_comment`: 指定されたコメントを更新
- `delete_comment`: 指定されたコメントを削除
- `get_comment`: 指定されたコメントの詳細情報を取得

## 開発

### 開発環境のセットアップ

```bash
# 依存関係をインストール
pnpm install

# 型チェック
pnpm type-check

# ビルド
pnpm build

# 開発モードで実行
pnpm dev
```

### プロジェクト構造

```
mcp-server-qiita/
├── src/
│   └── index.ts          # メインのMCPサーバーファイル
├── dist/                 # ビルド出力ディレクトリ
├── package.json          # プロジェクト設定
├── tsconfig.json         # TypeScript設定
└── README.md            # このファイル
```

## ライセンス

MIT License

## 貢献

プルリクエストやイシューの報告を歓迎します。

## 注意事項

- このサーバーはQiita API v2を使用しています
- 認証が必要な操作（記事の作成、更新、削除など）には有効なアクセストークンが必要です
- APIレート制限に注意してください（認証済みリクエスト: 1000回/時間、未認証リクエスト: 60回/時間）
- すべてのコメントとドキュメントは日本語で記述されています

---

## 関連プロジェクト

### MCP Server for Temporary Email

開発・テスト時に一時メールが必要な場合に、[mcp-server-tempmail](https://chat-tempmail.com/ja/mcp-server)をお試しください。

**mcp-server-tempmail**は、ChatTempMail APIを使用した一時メール管理のためのMCPサーバーです。AI開発ワークフローに一時メール機能をシームレスに統合し、以下の機能を提供します：

- **AI統合**: Cursor、Claude、VS Code Copilotなどの人気AIツールとのネイティブ統合
- **リアルタイム監視**: 一時受信箱にメールが届いたときに即座に通知
- **プライバシー保護**: 開発とテスト中に実際のメールアドレスをプライベートに保持
- **簡単セットアップ**: わずか数行のJSON設定で簡単に設定
- **柔軟な設定**: メール有効期限とWebhook設定をカスタマイズ

```bash
# NPMからインストール
npm install -g mcp-server-tempmail
```

詳細は[公式サイト](https://chat-tempmail.com/ja/mcp-server)をご覧ください。