Mo5 Mcp Server — Thomson Mo5 C Development Assistant

MO5 MCP サーバー（RAG コネクター）

この MCP サーバー（Model Context Protocol）は、最新の AI エージェント（Claude Desktop、Augment、Cursor）と Thomson MO5 エコシステムをつなぐ役割を果たします。
専門家向けナレッジベースへのアクセスと、MO5 のレガシーファイルの操作が可能です。

Thomson MO5 マイクロコンピューターを使った開発を支援するため、セマンティック検索ツール、ドキュメントリソース、専門家向けプロンプトを提供します。

🏗️ MO5 開発エコシステム

このサーバーは、最新の 6809 開発向けの包括的なツールチェーンの一部です。

• SDK MO5： https://github.com/thlg057/sdk_mo5
  CMOC 向けに最適化された C ライブラリです。
• MO5 Project Template： https://github.com/thlg057/mo5_template
  Makefile を自動生成するプロジェクトテンプレートです。
• この MCP サーバー：すべてをつなぎ、技術的な質問に回答し、アセットを生成するアシスタントです。

🌐 RAG インフラストラクチャ（人工知能）

このサーバーは、実際の技術ドキュメントに基づいた正確な回答を提供するため、Retrieval-Augmented Generation アーキテクチャを採用しています。

🚀 機能

• セマンティック検索：MO5 の技術ドキュメントを対象に、インテリジェントな検索を行います。
• リソースエクスプローラー：ドキュメント、タグ、インデックス作成状況の一覧に直接アクセスできます。
• 専門家向けプロンプト：AI 向けに設定済みの「Expert Thomson MO5」モードです。
• ビルドツール：起動可能な .fd ディスクイメージの生成、SDDrive 用の .fd から .sd への変換、PNG アセットから C スプライトヘッダーへの変換を行います。
• 堅牢性：タイムアウト（30s）をネイティブに処理し、不安定なネットワーク環境（NAS）向けの再試行ポリシーを備えています。

---

🌐 公開 MO5 RAG サーバー

MO5 RAG サーバーは、現在インターネット上に公開され、アクセス可能です。

👉 https://retrocomputing-ai.cloud/

この MCP サーバーは、公開 RAG インスタンスとすぐに使える状態で連携するように設計されています。

ほとんどのユーザーは、次の作業が不要です。

• RAG サーバーのインストール
• Docker のセットアップ
• ローカルインフラストラクチャの保守

MCP サーバーが公開 URL を参照するよう設定するだけで、コーディングエージェントから使い始められます。

次の目的がある場合は、引き続き RAG サーバーをセルフホストできます。

• 内部の仕組みを試す
• ナレッジベースをカスタマイズする
• すべてをオフラインで実行する

ただし、通常の使用では必要ありません。

🛠️ 必要条件

• Node.js（v18 以降）
• Pillow を含む Python 3（Pillow、pip install Pillow）— png_to_mo5_sprite ツールでのみ必要です。

公式の公開 MO5 RAG サーバーはこちらです：https://retrocomputing-ai.cloud/

この公開インスタンスを直接使用できるため、独自の RAG サーバーをホストする必要はありません。

📦 インストールとセットアップ

オプション 1 — npx 経由（推奨、インストール不要）

npm からサーバーを直接実行するようエージェントを設定します。git clone や npm install は不要です。

{
  "mcpServers": {
    "mo5-server": {
      "command": "npx",
      "args": [
        "-y",
        "@thlg057/mo5-rag-mcp"
      ],
      "env": {
        "RAG_BASE_URL": "https://retrocomputing-ai.cloud"
      }
    }
  }
}

オプション 2 — ソースから

git clone https://github.com/thlg057/mo5-mcp-server.git
cd mo5-mcp-server
npm install

次に、エージェントを設定します。

{
  "mcpServers": {
    "mo5-rag": {
      "command": "node",
      "args": ["C:\\your\\path\\to\\mo5-mcp-server\\index.js"],
      "env": {
        "RAG_BASE_URL": "https://retrocomputing-ai.cloud"
      }
    }
  }
}

Windows の場合：JSON の書式エラーを避けるため、パスにはバックスラッシュを 2 つ \\ 入れるか、スラッシュ / を使用してください。

🤖 エージェントへの統合（例：Augment、Claude Desktop）

上記の設定のいずれかを、MCP 設定ファイル（例：augment_config.json または claude_desktop_config.json）に追加します。

🧪 ローカルテスト

RAG API との通信が適切に行われることを確認するため、統合前にサーバーをテストすることをおすすめします。

MCP Inspector 経由（推奨）

# Windows (PowerShell)
$env:RAG_BASE_URL="https://retrocomputing-ai.cloud"; npx @modelcontextprotocol/inspector node index.js

コマンドライン経由

echo {"jsonrpc":"2.0","method":"tools/list","id":1} | node index.js

📂 プロジェクト構成

• index.js：MCP サーバーのメインソースコードです。
• scripts/：ビルドツール用の Python スクリプト（makefd.py、fd2sd.py、png2mo5.py）です。
• package.json：依存関係（MCP SDK）です。
• .gitignore：node_modules と環境ファイルを除外します。

🏗️ MO5 開発エコシステム

このサーバーは、Thomson MO5 での開発を現代化するために設計されたツール群の一部です。

• SDK MO5：アセンブリを記述せずに、ハードウェア（ビデオ、キーボード、モニター）へ簡単にアクセスできる CMOC 用 C ライブラリです。
• Project Template：すぐに使えるプロジェクトのひな形です。自動化された Makefile を備えており、単一のコマンドでコンパイルと SDK のリンクを行い、起動可能なディスクイメージを生成します。また、この MCP サーバーを開発用依存関係として含んでいるため、コーディングエージェントは最初からプロジェクトの全コンテキストとビルド機能を利用できます。

このプロジェクトは、Thomson MO5 マイクロコンピューターのデジタル保存エコシステムの一部です。