MCP Jena

🚀 Apache JenaのMCPサーバー

このプロジェクトは、AIエージェントがApache Jenaを通じてSPARQLクエリを実行できるようにするModel Context Protocol (MCP)サーバーを提供します。これにより、AIエージェントはApache Jenaに格納されたRDFデータにアクセスし、クエリを実行することができます。

🚀 クイックスタート

このMCPサーバーを使用することで、AIエージェント（Cursor、Claude for Cline、Claude Desktopなど）がApache Jenaに格納されたRDFデータにアクセスし、SPARQLクエリや更新操作を実行できるようになります。

✨ 主な機能

• Jena Fusekiサーバーに対するSPARQLクエリの実行
• RDFデータを変更するSPARQL更新の実行
• データセット内の利用可能な名前付きグラフのリスト表示
• Jena FusekiのHTTP Basic認証のサポート
• Model Context Protocolとの互換性

📦 インストール

前提条件

• Node.js（v16以上）
• RDFデータがロードされた正常に動作するApache Jena Fusekiサーバー
• Model Context ProtocolをサポートするAIエージェント（Cursor、Claude for Clineなど）

インストール手順

1. このリポジトリをクローンします：

   git clone https://github.com/ramuzes/mcp-jena.git
   cd mcp-jena
   

2. 依存関係をインストールします：

   npm install
   

3. TypeScriptコードをビルドします：

   npm run build
   

💻 使用例

基本的な使用法

デフォルト設定（Jenaアドレス：localhost:3030、データセット名：ds）でサーバーを起動します：

npm start

高度な使用法

カスタムのJenaエンドポイント、データセット、認証資格情報を指定してサーバーを起動します：

npm start -- --endpoint http://your-jena-server:3030 --dataset your_dataset --username your_username --password your_password

短いフラグを使用することもできます：

npm start -- -e http://your-jena-server:3030 -d your_dataset -u your_username -p your_password

開発モードで自動トランスパイル機能を付けて実行します：

npm run dev:transpile -- -e http://your-jena-server:3030 -d your_dataset -u your_username -p your_password

📚 ドキュメント

利用可能なツール

このMCPサーバーは以下のツールを提供します：

1. execute_sparql_query - Jenaデータセットに対するSPARQLクエリの実行
2. execute_sparql_update - データセットを変更するSPARQL更新クエリの実行
3. list_graphs - データセット内のすべての利用可能な名前付きグラフのリスト表示

環境変数

サーバーは環境変数を通じて構成することもできます：

サンプルSPARQLクエリ

基本的なSELECTクエリ：

SELECT ?subject ?predicate ?object
WHERE {
  ?subject ?predicate ?object
}
LIMIT 10

データ挿入のUPDATEクエリ：

PREFIX ex: <http://example.org/>
INSERT DATA {
  ex:subject1 ex:predicate1 "object1" .
  ex:subject2 ex:predicate2 42 .
}

特定の名前付きグラフのクエリ：

SELECT ?subject ?predicate ?object
FROM NAMED <http://example.org/graph1>
WHERE {
  GRAPH <http://example.org/graph1> {
    ?subject ?predicate ?object
  }
}
LIMIT 10

🔗 リソース

• Model Context Protocol (MCP)
• Apache Jena
• Node.js