Skip to main content
Glama
DonoueKen

wellulu-insight

by DonoueKen
README.md
# wellulu-insight

Claude との会話から自動でインサイトを GitHub Issues に保存する MCP サーバーです。

## 機能

- `create_insight` — インサイトを Issue として保存
- `list_insights` — カテゴリ・ステータスで一覧取得
- `search_insights` — キーワード検索

## セットアップ

### 1. 依存関係のインストール

```bash
npm install
```

### 2. GitHub Personal Access Token の作成

[GitHub Settings](https://github.com/settings/tokens/new?scopes=repo&description=wellulu-insight-mcp) で `repo` スコープのトークンを作成してください。

### 3. Claude Desktop への登録

`%APPDATA%\Claude\claude_desktop_config.json`(Windows)または  
`~/Library/Application Support/Claude/claude_desktop_config.json`(macOS)に追記:

```json
{
  "mcpServers": {
    "wellulu-insight": {
      "command": "node",
      "args": ["C:/path/to/wellulu-insight/mcp/index.mjs"],
      "env": {
        "GITHUB_TOKEN": "your_github_pat",
        "GITHUB_OWNER": "DonoueKen",
        "GITHUB_REPO": "wellulu-insight"
      }
    }
  }
}
```

### 4. Claude プロジェクト指示の設定

`prompts/claude-project-instructions.md` の内容を Claude のプロジェクト指示にコピーしてください。

## ディレクトリ構成

```
mcp/index.mjs                          # MCP サーバー本体
package.json                           # 依存関係
prompts/claude-project-instructions.md # Claude への自動保存指示
.github/ISSUE_TEMPLATE/insight.yml     # Issue テンプレート
```

TDQS

A3.5/5.0

Scored across 3 tools

Disambiguation5/5

Each tool has a clear and distinct purpose: create, list, and search insights. No overlap in functionality.

Naming Consistency5/5

All tools use a consistent verb_noun pattern in snake_case (create_insight, list_insights, search_insights).

Tool Count4/5

3 tools is slightly low but appropriate for a focused insight management server. Each tool serves a core operation.

Completeness3/5

The set covers create, list, and search, but lacks update and delete operations, which are notable gaps for full lifecycle management.

Maintenance

ActivityInactive
ResponsivenessNo issues