Tablestore:Tablestore MCP サービスのクイックスタート

Python

Tablestore MCP サービスの Python 版は、Python 3.10 以降を必要とし、パッケージおよび環境管理に uv を使用します。

Alibaba Cloud Linux 3.2104 LTS 64 ビットシステムにおけるデフォルトの Python 3 バージョンは 3.6.8 です。Python のバージョンアップに関する手順については、「Python バージョンのスペックアップ」をご参照ください。

1. MCP ソースコードディレクトリに移動します。

   cd alibabacloud-tablestore-mcp-server/tablestore-python-mcp-server

2. 仮想環境を作成し、有効化します。

   python3 -m venv .venv && source .venv/bin/activate

3. uv をインストールします。

   pip3 install uv

4. 環境変数を設定します。

   export HF_ENDPOINT=https://huggingface.co
   export TABLESTORE_ACCESS_KEY_ID=LTAI********************
   export TABLESTORE_ACCESS_KEY_SECRET=******************************
   export TABLESTORE_ENDPOINT=https://k01r********.cn-hangzhou.ots.aliyuncs.com
   export TABLESTORE_INSTANCE_NAME=k01r********

   環境変数の説明は以下のとおりです。

   変数名	説明
   HF_ENDPOINT	HuggingFace のアドレスです。
   TABLESTORE_ACCESS_KEY_ID	Alibaba Cloud アカウントまたは RAM ユーザーの AccessKey ID です。
   TABLESTORE_ACCESS_KEY_SECRET	Alibaba Cloud アカウントまたは RAM ユーザーの AccessKey Secret です。
   TABLESTORE_ENDPOINT	Tablestore インスタンスのエンドポイントです。ECS を使用している場合、リージョンに応じてエンドポイントを選択してください。 ECS と Tablestore が同一リージョンにある場合：パブリックエンドポイントまたは VPC エンドポイントを選択します。 ECS と Tablestore が異なるリージョンにある場合：パブリックエンドポイントを選択します。 重要 新規作成された Tablestore インスタンスでは、デフォルトでパブリックアクセスが有効になっていません。パブリックエンドポイントを使用するには、Tablestore コンソールにアクセスし、ネットワーク管理 タブ（インスタンス管理 ページ内）を開き、許可されるネットワークタイプ で インターネット を選択し、設定 をクリックして構成を保存します。
   TABLESTORE_INSTANCE_NAME	Tablestore インスタンスの名前です。

   その他のオプション環境変数

   変数名	説明
   SERVER_PORT	サービスが実行されるポートです。デフォルト値は 8001 です。
   TABLESTORE_TABLE_NAME	Tablestore データテーブルの名前です。デフォルト値は ts_mcp_server_py_v1 です。
   TABLESTORE_INDEX_NAME	Tablestore データテーブルの検索インデックスの名前です。デフォルト値は ts_mcp_server_py_index_v1 です。
   TABLESTORE_VECTOR_DIMENSION	ディメンション数です。デフォルト値は 768 です。ディメンション数は、埋め込みモデルのベクトルディメンションと一致させる必要があります。
   TABLESTORE_TEXT_FIELD	テキストフィールドの名前です。デフォルト値は _content です。
   TABLESTORE_VECTOR_FIELD	ベクトルフィールドの名前です。デフォルト値は _embedding です。
   EMBEDDING_PROVIDER_TYPE	埋め込みモデルプロバイダーです。現在は hugging_face のみがサポートされています。
   EMBEDDING_MODEL_NAME	埋め込みモデルの名前です。デフォルト値は BAAI/bge-base-zh-v1.5 です。埋め込みモデルのベクトルディメンションは、TABLESTORE_VECTOR_DIMENSION と一致させる必要があります。
   TOOL_STORE_DESCRIPTION	ストレージツールの説明です。
   TOOL_SEARCH_DESCRIPTION	取得ツールの説明です。

5. MCP サービスを実行します。

   uv run tablestore-mcp-server

   初回実行時は依存関係のダウンロードが必要です。しばらくお待ちください。ネットワークの問題でダウンロードが中断された場合は、コマンドを再度実行してください。サービスが正常に起動すると、以下のログが出力されます。

   INFO:tablestore_mcp_server.server:mcp host:0.0.0.0, port:8001
   INFO:root:run tablestore-mcp-server by: sse

Java

Tablestore MCP サービスの実行には、JDK17 が必要です。

1. JDK をインストールします。

   yum -y install java-17-openjdk-devel.x86_64

2. MCP ソースコードディレクトリに移動します。

   cd alibabacloud-tablestore-mcp-server/tablestore-java-mcp-server

3. ソースコードをコンパイルします。

   ./mvnw package -DskipTests -s settings.xml

   コンパイルが成功すると、以下のログが出力されます。

   [INFO] ------------------------------------------------------------------------
   [INFO] BUILD SUCCESS
   [INFO] ------------------------------------------------------------------------
   [INFO] Total time:  01:58 min
   [INFO] Finished at: 2025-03-26T11:31:21+08:00
   [INFO] ------------------------------------------------------------------------

4. 環境変数を設定します。

   export HF_ENDPOINT=http://hf-mirror.com
   export TABLESTORE_ACCESS_KEY_ID=LTAI********************
   export TABLESTORE_ACCESS_KEY_SECRET=******************************
   export TABLESTORE_ENDPOINT=https://k01r********.cn-hangzhou.ots.aliyuncs.com
   export TABLESTORE_INSTANCE_NAME=k01r********

   環境変数の説明は以下のとおりです。

   変数名	説明
   HF_ENDPOINT	HuggingFace ミラーアドレスです。
   TABLESTORE_ACCESS_KEY_ID	Alibaba Cloud アカウントまたは RAM ユーザーの AccessKey ID です。
   TABLESTORE_ACCESS_KEY_SECRET	Alibaba Cloud アカウントまたは RAM ユーザーの AccessKey Secret です。
   TABLESTORE_ENDPOINT	Tablestore インスタンスのエンドポイントです。ECS を使用している場合、リージョンに応じてエンドポイントを選択してください。 ECS と Tablestore が同一リージョンにある場合：パブリックエンドポイントまたは VPC エンドポイントを選択します。 ECS と Tablestore が異なるリージョンにある場合：パブリックエンドポイントを選択します。 重要 新規作成された Tablestore インスタンスでは、デフォルトでパブリックアクセスが有効になっていません。パブリックエンドポイントを使用するには、Tablestore コンソールにアクセスし、インスタンス管理 を選択し、ネットワーク管理 タブに移動し、許可されるネットワークタイプ で パブリック をチェックし、設定 をクリックして構成を保存します。
   TABLESTORE_INSTANCE_NAME	Tablestore インスタンスの名前です。

   その他のオプション環境変数

   変数名	説明
   SERVER_PORT	サービスが実行されるポートです。デフォルト値は 8080 です。
   TABLESTORE_TABLE_NAME	Tablestore データテーブルの名前です。デフォルト値は tablestore_java_mcp_server_v1 です。
   TABLESTORE_INDEX_NAME	Tablestore データテーブルの検索インデックスの名前です。デフォルト値は tablestore_java_mcp_server_index_v1 です。
   TABLESTORE_TABLE_PK_NAME	Tablestore データテーブルのプライマリキーの名前です。デフォルト値は id です。
   TABLESTORE_VECTOR_DIMENSION	ディメンション数です。デフォルト値は 768 です。ディメンション数は、埋め込みモデルのベクトルディメンションと一致させる必要があります。
   TABLESTORE_TEXT_FIELD	テキストフィールドの名前です。デフォルト値は _content です。
   TABLESTORE_VECTOR_FIELD	ベクトルフィールドの名前です。デフォルト値は _embedding です。
   EMBEDDING_MODEL_NAME	埋め込みモデルの名前です。デフォルト値は ai.djl.huggingface.rust/BAAI/bge-base-en-v1.5/0.0.1/bge-base-en-v1.5 です。埋め込みモデルのベクトルディメンションは、TABLESTORE_VECTOR_DIMENSION と一致させる必要があります。

5. MCP サービスを実行します。

   java -jar target/tablestore-java-mcp-server-1.0-SNAPSHOT.jar

   サービスが正常に起動すると、以下のログが出力されます。

   2025-03-26T11:35:31.519+08:00  INFO 5116 --- [           main] o.s.b.web.embedded.netty.NettyWebServer  : Netty started on port 8080 (http)
   2025-03-26T11:35:31.534+08:00  INFO 5116 --- [           main] c.a.openservices.tablestore.sample.App   : Started App in 44.143 seconds (process running for 44.766)

Linux

1. コマンドラインインターフェイスで以下のコマンドを実行し、環境変数設定を ~/.bashrc ファイルに追加します。

   echo "export TABLESTORE_ACCESS_KEY_ID='LTAI********************'" >> ~/.bashrc
   echo "export TABLESTORE_ACCESS_KEY_SECRET='******************************'" >> ~/.bashrc
   echo "export TABLESTORE_ENDPOINT='https://k01r********.cn-hangzhou.ots.aliyuncs.com'" >> ~/.bashrc
   echo "export TABLESTORE_INSTANCE_NAME='k01r********'" >> ~/.bashrc
   echo "export HF_ENDPOINT='http://hf-mirror.com'" >> ~/.bashrc

2. 以下のコマンドを実行して変更を適用します。

   source ~/.bashrc

3. 以下のコマンドを実行して、環境変数が有効になっているか確認します。

   echo $TABLESTORE_ACCESS_KEY_ID
   echo $TABLESTORE_ACCESS_KEY_SECRET
   echo $TABLESTORE_ENDPOINT
   echo $TABLESTORE_INSTANCE_NAME
   echo $HF_ENDPOINT

macOS

1. ターミナルで以下のコマンドを実行し、デフォルトのシェルタイプを確認します。

   echo $SHELL

2. デフォルトのシェルタイプに応じて操作を行います。

   Zsh

   1. 以下のコマンドを実行し、環境変数設定を ~/.zshrc ファイルに追加します。

      echo "export TABLESTORE_ACCESS_KEY_ID='LTAI********************'" >> ~/.zshrc
      echo "export TABLESTORE_ACCESS_KEY_SECRET='******************************'" >> ~/.zshrc
      echo "export TABLESTORE_ENDPOINT='https://k01r********.cn-hangzhou.ots.aliyuncs.com'" >> ~/.zshrc
      echo "export TABLESTORE_INSTANCE_NAME='k01r********'" >> ~/.zshrc
      echo "export HF_ENDPOINT='http://hf-mirror.com'" >> ~/.zshrc

   2. 以下のコマンドを実行して変更を適用します。

      source ~/.zshrc

   3. 以下のコマンドを実行して、環境変数が有効になっているか確認します。

      echo $TABLESTORE_ACCESS_KEY_ID
      echo $TABLESTORE_ACCESS_KEY_SECRET
      echo $TABLESTORE_ENDPOINT
      echo $TABLESTORE_INSTANCE_NAME
      echo $HF_ENDPOINT

   Bash

   1. 以下のコマンドを実行し、環境変数設定を ~/.bash_profile ファイルに追加します。

      echo "export TABLESTORE_ACCESS_KEY_ID='LTAI********************'" >> ~/.bash_profile
      echo "export TABLESTORE_ACCESS_KEY_SECRET='******************************'" >> ~/.bash_profile
      echo "export TABLESTORE_ENDPOINT='https://k01r********.cn-hangzhou.ots.aliyuncs.com'" >> ~/.bash_profile
      echo "export TABLESTORE_INSTANCE_NAME='k01r********'" >> ~/.bash_profile
      echo "export HF_ENDPOINT='http://hf-mirror.com'" >> ~/.bash_profile

   2. 以下のコマンドを実行して変更を適用します。

      source ~/.bash_profile

   3. 以下のコマンドを実行して、環境変数が有効になっているか確認します。

      echo $TABLESTORE_ACCESS_KEY_ID
      echo $TABLESTORE_ACCESS_KEY_SECRET
      echo $TABLESTORE_ENDPOINT
      echo $TABLESTORE_INSTANCE_NAME
      echo $HF_ENDPOINT

Windows

Python

MCP ソースコードをローカルで実行するための環境要件は以下のとおりです。

• Python 3.10 以降。

• PyCharm 2024.3.2 以降。

• PyCharm で uv 環境の構成 を行います。

環境構成を完了したら、PyCharm で MCP ソースコードディレクトリ tablestore-python-mcp-server を開き、src/tablestore_mcp_server/main.py ファイルを実行します。サービスが正常に起動すると、コンソールに以下のログが出力されます。

INFO:tablestore_mcp_server.server:mcp host:0.0.0.0, port:8001
INFO:root:run tablestore-mcp-server by: sse

Java

MCP ソースコードをローカルで実行するための環境要件は、JDK17 です。

環境構成を完了したら、IDEA で MCP ソースコードディレクトリ tablestore-java-mcp-server を開き、src/main/java/com.alicloud.openservices.tablestore.sample/App.java ファイルを実行します。サービスが正常に起動すると、コンソールに以下のログが出力されます。

2025-03-31T16:50:50.582+08:00  INFO 27160 --- [           main] o.s.b.web.embedded.netty.NettyWebServer  : Netty started on port 8080 (http)
2025-03-31T16:50:50.594+08:00  INFO 27160 --- [           main] c.a.openservices.tablestore.sample.App   : Started App in 79.764 seconds (process running for 80.524)