T1nker 1220 Memories With Lessons MCP Server

🚀 知識圖譜

本項目提供了一系列用於知識圖譜管理、文件操作、與Claude集成等功能的工具和方法，能幫助用戶高效地構建和管理知識圖譜系統。

🚀 快速開始

本項目提供了豐富的API接口，涵蓋知識圖譜實體與關係管理、文件操作、與Claude集成等功能。你可以根據自身需求調用相應的接口完成各類操作。

✨ 主要特性

• 提供創建、獲取、刪除知識圖譜實體、關係和觀察記錄的功能。
• 支持複雜的知識圖譜查詢，包括SPARQL查詢。
• 具備文件上傳、下載和刪除的管理功能。
• 可與Claude Desktop集成，實現命令交互。
• 提供項目構建工具，可分別構建服務器和客戶端。
• 新增課程創建和文件管理工具，增強了知識圖譜查詢功能。

📦 安裝指南

文檔未提供安裝步驟，暫不展示。

💻 使用示例

基礎用法

上傳文件示例

response = upload_file(file=open('example.txt', 'rb'), metadata={'author': 'John Doe'})
print(response)

下載文件示例

result = download_file(file_id='12345')
with open('downloaded.txt', 'wb') as f:
    f.write(result.content)

創建課程示例

lesson_data = {
    'title': 'Introduction to Python',
    'content': 'Basic Python programming concepts...',
    'level': 'Beginner',
    'status': 'Draft'
}
response = create_lesson(lesson=lesson_data)
print(response.status)

高級查詢示例

query = """
SELECT DISTINCT ?x
WHERE {
  ?x rdf:type ex:Course .
}
"""
results = sparql_query(query=query)
print(results)

高級用法

處理上傳失敗

try:
    upload_file(file=open('largefile.zip', 'rb'))
except UploadError as e:
    print(f"Upload failed: {e}")

處理查詢超時

try:
    results = advanced_query(query='SELECT * WHERE { ... }')
except QueryTimeout:
    print("Query execution timed out.")

📚 詳細文檔

工具方法

create_entity

• 創建實體
• 輸入: entity（對象）
• 包含: id, name, type, properties（屬性）
• 功能:
  • 根據提供的參數創建新的知識圖譜實體。
  • 自動跟蹤創建時間和更新狀態。

get_entity

• 獲取實體
• 輸入: entity_id（字符串）
• 輸出: 實體對象或錯誤信息
• 描述:
  • 根據指定的實體ID返回對應的實體信息。
  • 如果未找到實體，將返回錯誤提示。

delete_entity

• 刪除實體
• 輸入: entity_id（字符串）
• 輸出: 成功或失敗的狀態消息
• 功能:
  • 根據提供的實體ID從知識圖譜中刪除相應的實體。
  • 返回操作結果的狀態信息。

create_relation

• 創建關係
• 輸入: relation（對象）
• 包含: from_id, to_id, type, properties
• 功能:
  • 在指定的兩個實體之間建立新的關聯關係。
  • 自動記錄操作時間和狀態信息。

get_relation

• 獲取關係
• 輸入: relation_id（字符串）
• 輸出: 關係對象或錯誤信息
• 描述:
  • 根據提供的關係ID返回對應的關係詳情。
  • 如果未找到關係，將返回錯誤提示。

delete_relation

• 刪除關係
• 輸入: relation_id（字符串）
• 輸出: 成功或失敗的狀態消息
• 功能:
  • 根據指定的關係ID從知識圖譜中移除相應的關聯。
  • 返回操作結果的狀態信息。

create_observation

• 創建觀察
• 輸入: observation（對象）
• 包含: content, type, source, timestamp
• 功能:
  • 添加一條新的觀察記錄到知識圖譜中。
  • 自動處理時間戳和來源信息。

get_observation

• 獲取觀察
• 輸入: observation_id（字符串）
• 輸出: 觀察對象或錯誤信息
• 描述:
  • 根據指定的觀察ID返回對應的觀察內容。
  • 如果未找到觀察記錄，將返回錯誤提示。

delete_observation

• 刪除觀察
• 輸入: observation_id（字符串）
• 輸出: 成功或失敗的狀態消息
• 功能:
  • 根據提供的觀察ID從知識圖譜中刪除相應的記錄。
  • 返回操作結果的狀態信息。

知識圖譜查詢

query Knowledge Graph

• 複雜查詢
• 輸入: query（字符串）
• 輸出: 查詢結果或錯誤信息
• 功能:
  • 執行復雜的SPARQL或其他查詢語言以獲取知識圖譜中的數據。
  • 支持多種查詢類型，返回結構化結果。

sparql_query

• 執行SPARQL查詢
• 輸入: query（字符串）
• 輸出: 查詢結果或錯誤信息
• 描述:
  • 使用SPARQL語言進行特定的數據檢索或分析。
  • 返回符合查詢條件的結果集。

文件管理

upload_file

• 上傳文件
• 輸入: file（文件對象），metadata（元數據）
• 輸出: 成功或失敗的狀態消息
• 功能:
  • 將文件上傳到指定的存儲位置。
  • 同時記錄文件的相關元數據信息。

download_file

• 下載文件
• 輸入: file_id（字符串）
• 輸出: 文件內容或錯誤信息
• 描述:
  • 根據提供的文件ID獲取對應的文件內容。
  • 支持多種文件格式和大小的下載請求。

delete_file

• 刪除文件
• 輸入: file_id（字符串）
• 輸出: 成功或失敗的狀態消息
• 功能:
  • 根據指定的文件ID從存儲中移除相應的文件。
  • 返回操作結果的狀態信息。

與Claude Desktop集成

setup_claude

• 配置Claude
• 輸入: config（對象）
• 包含: api_key, endpoint, parameters
• 功能:
  • 配置Claude API的連接參數和設置。
  • 確保與Claude服務順利集成。

cl_指令

• 執行Claude命令
• 輸入: command（字符串）
• 輸出: 命令結果或錯誤信息
• 描述:
  • 發送特定的命令到Claude進行處理。
  • 返回執行後的響應結果。

構建說明

build_server

• 構建服務器
• 輸入: 無
• 輸出: 成功或失敗的狀態消息
• 功能:
  • 執行項目的構建流程，生成可運行的服務器程序。
  • 自動處理依賴項和配置文件。

build_client

• 構建客戶端
• 輸入: 無
• 輸出: 成功或失敗的狀態消息
• 功能:
  • 編譯客戶端程序，確保所有模塊正確整合。
  • 返回構建完成後的狀態信息。

新功能介紹

新增課程創建工具

create_lesson

• 創建課程
• 輸入: lesson（對象）
• 包含: title, content, level, status
• 功能:
  • 根據提供的參數創建新的課程記錄。
  • 自動跟蹤課程的創建時間和狀態變化。

get_lesson

• 獲取課程
• 輸入: lesson_id（字符串）
• 輸出: 課程對象或錯誤信息
• 描述:
  • 根據指定的課程ID返回對應的課程詳情。
  • 如果未找到課程，將返回錯誤提示。

delete_lesson

• 刪除課程
• 輸入: lesson_id（字符串）
• 輸出: 成功或失敗的狀態消息
• 功能:
  • 根據提供的課程ID從系統中移除相應的課程記錄。
  • 返回操作結果的狀態信息。

新增文件管理工具

file_operations

• 文件操作
• 輸入: file（文件對象），action（字符串）
• 輸出: 操作結果或錯誤信息
• 功能:
  • 執行上傳、下載和刪除等文件相關操作。
  • 返回每個操作的結果狀態。

知識圖譜查詢增強

advanced_query

• 高級查詢
• 輸入: query（字符串）
• 輸出: 查詢結果或錯誤信息
• 描述:
  • 支持複雜的SPARQL查詢和自定義SQL語句。
  • 返回結構化的數據結果。

狀態碼說明

• 200: 成功完成請求。
• 400: 請求參數錯誤或缺失。
• 401: 需要身份驗證。
• 403: 沒有足夠權限。
• 404: 資源未找到。
• 500: 服務器內部錯誤。

🔧 技術細節

文檔未提供技術實現細節，暫不展示。

📄 許可證

license_info

• 獲取許可證信息
• 輸入: 無
• 輸出: 許可證詳情或錯誤信息
• 描述:
  • 返回當前項目的許可證相關信息。
  • 包括許可證類型、版本和條款等內容。

⚠️ 重要提示

• 確保所有API調用都包含有效的身份驗證信息。
• 及時處理上傳和下載過程中的異常情況。
• 定期檢查許可證的有效性和更新狀態。

💡 使用建議

在使用過程中，建議仔細閱讀各API的輸入輸出要求，確保傳入正確的參數。同時，對於可能出現的異常情況，要做好相應的錯誤處理。

📞 聯繫方式

• 技術支持: support@knowledgegraph.com
• 反饋提交: feedback@knowledgegraph.com
• 更多文檔: https://docs.knowledgegraph.com