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