Cangje Docs MCP

🚀 倉頡言語ドキュメント検索システム - Claude Code設定ガイド

これはClaude Code用に設計された倉頡言語ドキュメント検索MCPサーバーです。Claude Code内で効率的に倉頡プログラミング言語のすべてのドキュメントを検索できます。

🚀 Claude Codeの設定

ステップ1：mcp実行ファイルのダウンロード

• ダウンロード 倉頡ファイルmcp実行ファイル

ステップ2：ドキュメントディレクトリの準備

方法1：公式ドキュメントのダウンロード

# 公式ドキュメントリポジトリをクローン
git clone https://gitcode.com/Cangjie/CangjieCorpus.git

方法2：既存のドキュメントの使用

倉頡言語ドキュメントを実行ファイルのあるディレクトリにコピーします：

# プロジェクトのルートディレクトリにCangjieCorpusディレクトリがあることを確認
# または -dir パラメータでドキュメントディレクトリを指定

ステップ3：Claude Codeの設定

1. Claude Codeの設定を開く
2. MCPサーバーの設定を見つける
3. 以下の設定を追加する：

{
  "mcpServers": {
    "cangjie-docs": {
      "command": "/path/to/cangje-docs-mcp",
      "args": ["-dir", "/path/to/CangjieCorpus"]
    }
  }
}

ステップ4：Claude Codeの再起動

新しいMCPサーバーを読み込むためにClaude Codeを再起動します。

CLAUDE.md にこのリポジトリの cj_syntax.md を追加します。これは、倉頡の基礎文法をコンテキストに常駐させることに相当します（倉頡に対して微調整されたLLMを使用する場合は不要です）。

💻 使用例

基本的な使用法

倉頡言語の関数定義の構文を教えてください

分類検索

倉頡言語の基本データ型について知りたい

学習パス

初心者です。倉頡言語の学習順序を教えてください

具体的な質問

倉頡言語で並行プログラミングをどう処理するのですか？

API検索

倉頡標準ライブラリには、ファイル操作に関連するAPIは何がありますか？

🎯 よく使う検索例

構文検索

• "倉頡言語の変数宣言構文"
• "クラスを定義する方法"
• "倉頡の制御フロー文"

概念学習

• "倉頡言語のジェネリックプログラミングを説明してください"
• "倉頡のエラー処理メカニズム"
• "倉頡のパッケージ管理システム"

実践的な問題

• "倉頡でファイルを読み書きする方法"
• "倉頡のネットワークプログラミングの例"
• "倉頡とJavaScriptの相互作用"

API参照

• "倉頡のStringクラスのメソッド"
• "倉頡の配列操作API"
• "倉頡のHTTPクライアントの使用方法"

🔧 高度な機能

指定分類検索

manual分類で継承に関する内容を検索してください

関連する提案の取得

「関数定義」をテーマに関連する学習内容を提案してください

ナビゲーション閲覧

倉頡ドキュメントの完全なディレクトリ構造を表示してください

📋 設定の確認

バージョン情報の検証

./cangje-docs-mcp -version

以下のように表示されるはずです：

倉頡言語ドキュメント検索システム v1.0.0
MCPプロトコルに基づくローカルドキュメント検索サーバー
ドキュメントバージョン: v1.0.0 (リリース日: 2025-07-01)

ヘルプの表示

./cangje-docs-mcp -help

🛠️ トラブルシューティング

よくある問題

Q: Claude CodeがMCPサーバーを見つけられません A: 設定ファイルのパスが正しいことを確認し、実行ファイルに実行権限があることを確認します。

Q: 検索結果が空です A: ドキュメントディレクトリが存在し、倉頡ドキュメントが含まれていることを確認し、ドキュメントディレクトリの権限を確認します。

Q: 起動時にドキュメントディレクトリが存在しないというエラーが表示されます A: -dir パラメータで正しいドキュメントディレクトリのパスを指定します。

Q: MCPサーバーが起動できません A: 設定フォーマットが正しいことを確認し、正しいパラメータ形式を使用していることを確認します。

正しいMCP設定フォーマット

{
  "mcpServers": {
    "cangje-docs": {
      "type": "stdio",
      "command": "/path/to/cangje-docs-mcp",
      "args": ["-dir", "/path/to/CangjieCorpus"],
      "env": {}
    }
  }
}

重要: "type": "stdio" と "env": {} フィールドが含まれていることを確認してください。

デバッグモード

# MCPサーバーを直接実行して起動ログを確認
./cangje-docs-mcp -dir /path/to/CangjieCorpus

# バージョン情報を確認
./cangje-docs-mcp -version

# ヘルプ情報を表示
./cangje-docs-mcp -help

📖 ドキュメントのディレクトリ構造

ドキュメントのディレクトリ構造が以下のようになっていることを確認してください：

CangjieCorpus/
├── README.md
├── manual/              # 基礎マニュアル
│   ├── first_understanding/
│   ├── basic_data_type/
│   ├── function/
│   └── ...
├── libs/                # 標準ライブラリAPI
│   └── std/
├── tools/               # 開発ツール
└── extra/               # 追加内容

🎉 使い始める

設定が完了したら、Claude Code内で自然に倉頡言語のすべてのドキュメント内容を検索できます！システムが自動的に質問を理解し、関連するドキュメント内容と提案を提供します。