Pharo MCP Server

🚀 Pharo MCP サーバ

Pharo Smalltalkで実装されたAnthropicのモデルコンテキストプロトコル (MCP) サーバ仕様。ClaudeなどのLLMがPharoアプリケーションとやり取りできるようにします。

📚 目次

• MCPとは？
• プロジェクトの目標
• 機能
• インストール
• 基本的な使用法
• ツールの定義
• 設定
• 開発と貢献
• ライセンス

📖 MCPとは？

モデルコンテキストプロトコル (MCP) は、Anthropicによって開発された仕様で、大規模言語モデル (LLMs) とその外部ツールやサービスとのやり取り方法を標準化することを目的としています。以下のメカニズムを定義しています。

1. 発見： LLMがあるサービスがMCPをサポートしているかどうかを判断し、基本情報を取得する方法。
2. サービスの説明： サービスが利用可能なツール（機能）を、ツールの名前、目的、入力パラメータ、出力形式を含めて説明する方法。
3. 呼び出し： LLMが特定のプロトコルを介してツールを安全に呼び出し、必要なパラメータを渡し、結果を受け取る方法。

目標は、LLMのツール使用をより信頼性が高く、安全で、標準化されたものにすることです。

詳細については、公式の モデルコンテキストプロトコルGitHub組織 を参照してください。

🎯 プロジェクトの目標

このプロジェクトは、Pharo Smalltalk 環境に強力で使いやすい MCP仕様のサーバ側実装 を提供することを目的としています。

開発者は、Pharoアプリケーション内の機能（データのクエリ、オブジェクトの作成、操作のトリガーなど）を「ツール」として公開することができ、MCP互換のLLM（Claude 3など）が標準化されたプロトコルを介してこれらのツールを発見し、呼び出すことができます。

これにより、Pharo環境と最新のLLM機能の間に架け橋がかけられます。

✨ 主な機能

• MCP仕様準拠： コアサーバ側エンドポイントを実装します。
  • 発見 (/.well-known/model-context)
  • サービスの説明 (/mcp/description - または設定可能なパス)
  • 呼び出し (/mcp/invoke - または設定可能なパス)
• 動的なツール登録： PharoのメソッドやコードブロックをMCPツールとして登録するための簡単なAPIを提供します。
• 自動サービス説明生成： 登録されたツールとそのメタデータ（名前、説明、スキーマ）に基づいて、MCPサービス説明JSONを生成します。
• Webサーバ統合： Teapot マイクロWebフレームワークをベースにしています。
• JSON処理： NeoJSON を使用して強力なJSON解析と生成を行います。
• 拡張性： より大規模なPharoアプリケーションに統合できるように設計されています。
• （計画中）： JSONスキーマ定義を使用したツールパラメータの入力検証。
• （計画中）： 一般的なPharoオブジェクトモデルの統合を支援するヘルパー（例：Voyage の使用）。

📦 インストール

このプロジェクトは、Metacelloを介してロードすることを想定しています。

1. MetacelloがあなたのPharoイメージにロードされていることを確認（通常はすでにロードされています）。
2. Pharoワークスペースで以下のコードを実行（必要に応じてリポジトリURLとブランチ/タグを調整）：

Metacello new
    baseline: 'MCPFramework'; "<- 実際のベースラインクラス名（'BaselineOf'を除く）を使用"
    repository: 'github://YOUR_USERNAME/pharo-mcp-server:main/'; "<- このリポジトリのURLとブランチ/タグに変更"
    load.