Oh Card Helper Mcp Server

OHカード心理投影ツール MCP サーバー (OH Cards MCP Server)

🌟 MCP（Model Context Protocol）に基づく OH カード心理投影ツールサーバーです。複数のデプロイ方法を提供し、ユーザーが OH カードを通じて自己探求や内面への洞察を深めるのに役立ちます。

🎴 OH カードとは？

OH カード（Open Heart Cards）は、画像を通じて人々が内面世界を探求し、洞察やひらめきを得るのを助ける心理投影ツールです。同じカードに対する解釈は人それぞれ異なり、そこが OH カードの魅力です。

主な価値

• 🎯 投影ツール：画像を通じて内面の状態や感情を投影します
• 🌟 自己探求：内なるニーズや潜在意識を深く理解します
• 💡 思考を促す：問題や課題を新しい視点から捉えます
• 🌈 感情表現：言葉にしにくい感情を表現するのに役立ちます
• 🔮 直感とのつながり：内なる知恵や直感的な洞察を呼び覚まします

📁 プロジェクト構成

本プロジェクトでは、さまざまな利用シーンやデプロイ要件に対応するため、4種類の MCP 実装方法を提供しています：

OH-Card-Helper-MCP-server/
├── ohcard-fastmcp/         # 🐍 FastMCP Python 实现（最简单）
├── ohcard-npx-pack/        # 📦 NPX 包实现（最方便）
├── ohcard-cloud/           # ☁️ 云托管实现（可申请 MCP.so）
├── cloud-server/           # 🐳 Docker 云部署（实验性，已废弃）
├── intro.md               # 项目介绍
├── LICENSE                # MIT 许可证
└── README.md              # 本文件

🚀 4種類の実装方法の詳細

1. 🐍 ohcard-fastmcp - Python 版（最も簡単）

対象：Python 開発者、手軽にローカルへデプロイしたい方

• 技術スタック：Python + FastMCP フレームワーク
• 特徴：コードが簡潔で、理解や変更が容易です
• デプロイ：ローカルの Python 環境で実行します
• 利点：開発のハードルが低く、MCP 開発の学習に適しています

cd ohcard-fastmcp
pip install -r requirements.txt
python ohcard.py

2. 📦 ohcard-npx-pack - NPX パッケージ版（最も手軽）

対象：一般ユーザー、ワンコマンドで使いたい方

• 技術スタック：Node.js + TypeScript
• 特徴：設定不要で、コマンド一つですぐに使えます
• デプロイ：NPM で公開され、npx から直接実行できます
• 利点：ユーザー体験が最良で、環境設定が不要です

# 直接使用（推荐）
npx @cosmowind/ohcard-mcp

# Claude Desktop 配置
{
  "mcpServers": {
    "ohcard": {
      "command": "npx",
      "args": ["-y", "@cosmowind/ohcard-mcp"]
    }
  }
}

3. ☁️ ohcard-cloud - クラウドホスト版（MCP.so への申請が可能）

対象：MCP Playground で使いたい方

• 技術スタック：TypeScript + @chatmcp/sdk
• 特徴：stdio と REST の両方のトランスポートモードに対応しています
• デプロイ：MCP.so の公式ホスティングに申請できます
• 利点：ローカルへのインストールが不要で、オンラインですぐに使えます

ohcard-npx-pack をベースに改良し、MCP.so のホスティング要件を満たしています：

• パラメーター処理に getParamValue を使用
• REST API モードに対応
• Dockerfile と chatmcp.yaml の設定を含む

4. 🐳 cloud-server - Docker クラウドデプロイ版（廃止済み）

状態：実験的プロジェクト、デプロイに失敗

• 当初の計画：クラウドサーバー上に Docker で MCP サーバーをデプロイ
• 問題点：MCP プロトコルは主にローカルの stdio 通信向けに設計されており、クラウドへのデプロイには技術的な障壁があります
• 結果：プロジェクトは廃止され、学習用の参考として残されています

📊 方法の比較

特徴	FastMCP	NPXパッケージ	クラウドホスト	Dockerクラウドデプロイ
デプロイの難易度	簡単	非常に簡単	中程度	複雑
使いやすさ	中程度	非常に高い	高い	低い
技術的なハードル	低い	なし	中程度	高い
適した用途	開発学習	日常利用	オンライン体験	廃止済み
保守コスト	低い	低い	中程度	高い
拡張性	高い	中程度	中程度	高い
状態	✅ 安定	✅ 推奨	✅ 利用可能	❌ 廃止

🎯 機能

利用可能なすべてのバージョンで、以下の機能を提供します：

主なツール

ツール名	機能の説明	パラメーター
what_is_oh_cards	OH カードの詳細な紹介を取得	なし
get_oh_card_process	OH カードを引く手順のガイダンスを取得	なし
draw_oh_card	OH カードをランダムに1枚引く	intention（任意）
get_guidance_questions	探求に役立つガイド質問を取得	question_type（任意）
get_all_question_types	すべてのガイド質問の種類を確認	なし
get_all_cards_preview	すべての OH カード画像をプレビュー	なし

ガイド質問の種類

• 観察と感情：カードを観察し、第一印象を感じ取るのに役立ちます
• 深い探求：カードの細部や意味を掘り下げるよう促します
• 状況への没入：カードの状況に入り込めるようにします
• 内面とのつながり：カードと内面世界とのつながりを築きます
• 行動へのひらめき：カードから実生活で役立つ指針を得ます

🎮 使用手順

1. 意図を定める：探求したい問題や悩みを明確にします
2. カードを引く：draw_oh_card を使って OH カードをランダムに1枚引きます
3. 観察と感情：カードの画像を注意深く観察し、第一印象を記録します
4. ガイドに沿った探求：get_guidance_questions でガイド質問を取得します
5. 深く考える：ガイド質問に答え、内なる声を探ります
6. 洞察を得る：今回の体験から得たひらめきや洞察をまとめます

🛠️ クイックスタート

推奨方法：NPX パッケージ（設定不要）

# 一键启动
npx @cosmowind/ohcard-cloud-mcp

開発者向け：FastMCP

cd ohcard-fastmcp
pip install -r requirements.txt
python ohcard.py

オンラインで試す：クラウドホスト版

MCP.so の審査が通過すると、MCP Playground で直接利用できます。

📝 会話例

用户：我最近在工作上遇到一些困惑，想用 OH 卡来探索一下内心的声音。

Claude：我来帮你使用 OH 卡进行内心探索。让我先为你抽取一张 OH 卡。

[调用 draw_oh_card 工具]

你抽到的OH卡是xxx（链接）...

现在让我为你提供一些引导问题来深入探索这张卡的含义：

[调用 get_guidance_questions 工具]

1. 当你看到这张图片时，你的第一感受是什么？
2. 如果你现在身处其中，你会怎么做？
...

🔧 技術アーキテクチャ

FastMCP 版

• 言語：Python 3.8+
• フレームワーク：FastMCP
• トランスポート：stdio
• 依存関係：minimal

NPX／クラウドホスト版

• 言語：TypeScript/Node.js 18+
• フレームワーク：@modelcontextprotocol/sdk
• トランスポート：stdio + REST（クラウドホスト）
• ビルド：TypeScript のコンパイル

📚 ドキュメントリンク

• FastMCP 実装ドキュメント
• NPX パッケージ開発ガイド
• クラウドホスト設定の説明

🤝 貢献ガイド

プロジェクトへのコードや提案の貢献を歓迎します！

1. 本プロジェクトを Fork します
2. 適切な実装バージョンを選んで変更します
3. 機能ブランチを作成します
4. Pull Request を送信します

📄 ライセンス

MIT License - 詳細は LICENSE ファイルを参照してください

🔗 関連リンク

• Model Context Protocol (MCP)
• Claude Desktop
• FastMCP フレームワーク
• NPM パッケージ
• MCP.so 公式サイト

🌟 プロジェクトの特長

• 複数の方法に対応：シンプルな Python スクリプトからクラウドホストまで、さまざまなニーズに対応します
• 設定不要ですぐに使える：NPX パッケージならワンコマンドで起動できます
• 専門的な心理ツール：確立された OH カード心理投影理論に基づいています
• オープンソースで参加しやすい：MIT ライセンスを採用し、コミュニティからの貢献を歓迎します
• MCP エコシステム：MCP エコシステムの発展に積極的に参加します

---

自分に最適な方法を選び、OH カードの探求を始めましょう！ ✨

💡 推奨する利用順：NPX パッケージ（日常利用）→ FastMCP（開発学習）→ クラウドホスト（オンライン体験）