Personal DB MCP Server
Provides structured personal data (skills, experiences, values) as context to AI services, enabling personalized outputs across different AI applications.
README
Personal DB MCP Server
AIサービス横断で個人データをコンテキストとして提供する MCP サーバー。
なぜ必要か
AIに文章を書かせると、誰が書いても同じような出力になる。Personal DB は「自分」のデータ(経歴、スキル、価値観、エピソード、思考習慣など)を構造化して保持し、AIが動的に参照できるようにする。これにより、AIの出力に一貫した「自分らしさ」が乗る。
ユースケース
AI のコンテキストとして使う(最も重要)
| シーン | 何が起きるか |
|---|---|
| 質問への回答 | 「あなたの強みは?」→ DB のスキル・実績・エピソードから根拠付きで回答 |
| 文章・コンテンツ生成 | ブログ、SNS投稿、提案書などに自分の価値観・トーン・実績が自然に反映される |
| 執筆支援 | 小説・記事の著者としてのパーソナリティ(文体、思想、スタンス)を前提に載せる |
| チャットボット | 自分の分身として応答するボットに、動的な個人データを注入 |
| マルチエージェント | 複数の AI エージェントが同じ「自分」のデータを参照して協調動作 |
キャリア支援
| プロンプト | 用途 |
|---|---|
generate_resume |
対象ロール・企業に合わせた職務経歴書を生成 |
self_introduction |
面接・カンファレンス・カジュアルなど場面に応じた自己紹介 |
skill_assessment |
求人票 (JD) に対するスキルマッチ分析 |
interview_prep |
想定質問 + STAR形式の回答案 + 逆質問案 |
gap_analysis |
目標ロールとの差分分析 + 学習ロードマップ |
story_finder |
テーマ・コンピテンシーに合うエピソード検索 |
データメンテナンス
| プロンプト | 用途 |
|---|---|
data_collection |
DB の空白を特定し、埋めるためのインタビュー質問を生成 |
セットアップ
環境変数
SUPABASE_URL=https://your-project.supabase.co
SUPABASE_SERVICE_ROLE_KEY=your-service-role-key
PERSONAL_DB_API_KEY= # マルチテナント時のみ
ローカル (stdio)
npm install && npm run build
node dist/index.js
Claude Code で使う
.mcp.json または ~/.claude.json に追加:
{
"mcpServers": {
"personal-db": {
"type": "stdio",
"command": "node",
"args": ["/path/to/personal-db-mcp/dist/index.js"],
"env": {
"SUPABASE_URL": "https://your-project.supabase.co",
"SUPABASE_SERVICE_ROLE_KEY": "your-service-role-key"
}
}
}
}
リモート (Vercel)
vercel deploy --prod
エンドポイント: https://your-app.vercel.app/mcp
認証: Authorization: Bearer <API_KEY>
ツール一覧
CRUD (16 エンティティ × 5 操作 = 80 ツール)
各エンティティに list_*, get_*, create_*, update_*, delete_* を提供。
| エンティティ | 説明 |
|---|---|
profiles |
基本プロフィール、ミッション、価値観、トーン |
career_entries |
職歴・経歴 |
skills |
スキル(カテゴリ・習熟度付き) |
projects |
プロジェクト実績 |
achievements |
表彰・受賞・資格 |
episodes |
具体的なエピソード・体験談 |
education |
学歴・教育歴 |
hobbies |
趣味・興味 |
values_philosophy |
価値観・哲学・信条 |
health_entries |
健康・ウェルネス |
life_events |
ライフイベント |
relationships |
人間関係 |
goals |
目標・進捗 |
custom_categories |
ユーザー定義カテゴリ |
custom_entries |
カスタムカテゴリのエントリ |
personas |
コンテキスト生成用ペルソナ定義 |
コンテキスト生成
| ツール | 説明 |
|---|---|
get_context |
ペルソナベースの重み付きコンテキストを Markdown で生成。persona, focus, max_tokens_hint で制御可能 |
list_available_personas |
利用可能なペルソナ一覧(プリセット + カスタム) |
プリセットペルソナ: default, professional, interview, personal, creative
検索・分析
| ツール | 説明 |
|---|---|
search |
全テーブル横断のキーワード検索 |
get_stats |
テーブルごとのエントリ数・充実度 |
タグ・リレーション
| ツール | 説明 |
|---|---|
tag_entry / untag_entry |
エントリへのタグ付け・解除 |
create_relation / get_relations / delete_relation |
エンティティ間の関連付け |
一括操作
| ツール | 説明 |
|---|---|
bulk_import |
JSON データの一括インポート |
bulk_export |
全データまたは指定テーブルの一括エクスポート |
リソース (MCP Resources)
| URI | 説明 |
|---|---|
personaldb://profile/summary |
プロフィール全体概要 |
personaldb://career/timeline |
時系列の職歴 |
personaldb://skills/matrix |
カテゴリ別スキルマトリクス |
personaldb://portfolio |
プロジェクト + 実績 |
personaldb://resume/data |
履歴書用の構造化データ |
personaldb://episodes/highlights |
重要エピソード(importance 7以上) |
personaldb://goals/active |
アクティブな目標と進捗 |
personaldb://context |
重み付きコンテキスト(デフォルトペルソナ) |
アーキテクチャ
- DB: Supabase (PostgreSQL) -
personal_dbスキーマに全テーブルを分離 - 認証: API キーベース(マルチテナント対応)
- RLS: 全テーブルに Row Level Security 設定済み
- トランスポート: stdio (ローカル) / HTTP (Vercel デプロイ)
Recommended Servers
playwright-mcp
A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.
Magic Component Platform (MCP)
An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.
Audiense Insights MCP Server
Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.
VeyraX MCP
Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.
graphlit-mcp-server
The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.
Kagi MCP Server
An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.
E2B
Using MCP to run code via e2b.
Neon Database
MCP server for interacting with Neon Management API and databases
Exa Search
A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
Qdrant Server
This repository is an example of how to create a MCP server for Qdrant, a vector search engine.