在 DeepSeek Harness (DSH) 中處理 Web3 項目時,開發者需要頻繁查閱 React 組件庫文檔、確認 Props 定義或查找 Celo Composer CLI 的用法。這個插件是一個 MCP 服務器,爲 Composer Kit React 組件庫提供文檔、示例和使用信息,專爲在 Celo 區塊鏈上構建應用而設計。
核心功能¶
該插件提供以下能力:
- 組件檢索與管理:列出所有可用組件及其類別;按名稱、描述或功能搜索組件;按特定類別(如 ‘Wallet Integration’、’Payment & Transactions’)篩選組件。
- 組件詳情與代碼:獲取特定組件的詳細信息,包括源代碼、Props 定義和用法說明;獲取組件的真實使用示例代碼。
- 開發輔助:獲取 Composer Kit 的安裝指南;獲取 Celo Composer CLI
create命令的詳細文檔,包括--description、--wallet-provider等選項。 - 配置與持久化:在聊天中設置 API 密鑰,該密鑰會自動持久化,重啓後仍然有效。
安裝與啓用¶
在 DSH 環境中安裝此插件:
dsh plugin --profile web add github:xby-skill/xby-react-composer-kit
安裝完成後,插件將作爲 MCP 服務器在當前 DSH 進程中運行。
配置說明¶
API 密鑰¶
使用該插件前,需要前往小笨羊官網註冊並獲取 API 密鑰。在 DSH 對話中調用 set_xby_apikey 功能設置密鑰。
項目信息¶
該插件的 package.json 配置如下:
{
"name": "xby-react-composer-kit",
"version": "1.0.0",
"license": "MIT",
"type": "module",
"main": "./dist/index.js",
"files": [
"dist",
"cordis.patch.yml"
]
}
典型用法¶
- 列出組件:先執行
list_components查看當前有哪些可用的 React 組件。 - 搜索組件:如果已知組件名稱或功能,使用
search_components快速定位。 - 獲取詳情:使用
get_component獲取組件的源碼和 Props 定義;使用get_component_example獲取可直接運行的代碼示例。 - 篩選組件:使用
get_components_by_category查看特定分類下的組件(例如查看所有 NFT 相關組件)。 - 配置環境:在對話中輸入
set_xby_apikey並提供密鑰,完成配置。 - CLI 輔助:在編寫 Celo 項目腳手架命令時,使用
get_celo_composer_cli_info查詢create命令的可用參數。
適用場景與注意¶
- 適用對象:使用 Composer Kit 和 React 構建基於 Celo 區塊鏈應用的開發者。
- 本地調試:插件提供“方式二(本地目錄安裝)”和“方式三(通過 cordis.patch.yml)”用於本地開發調試,這兩種方式僅用於開發階段,不建議在生產環境直接使用。
- 權限檢查:插件以當前 DSH 進程的權限運行。安裝前,建議檢查源碼與許可證(MIT)。
- 依賴:核心功能依賴小笨羊 API 服務,請確保網絡連通性及密鑰的有效性。