T1nker 1220 Memories With Lessons MCP Server

🚀 知识图谱

本知识图谱项目提供了一系列丰富的功能，涵盖实体与关系管理、知识查询、文件操作、与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语句，返回结构化的数据结果。

🔧 技术细节

文档未提及技术实现细节，故跳过此章节。

📄 许可证

license_info

• 功能：获取许可证信息
• 输入：无
• 输出：许可证详情或错误信息
• 描述：返回当前项目的许可证相关信息，包括许可证类型、版本和条款等内容。

📊 状态码说明

⚠️ 错误处理

处理上传失败

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.")

⚠️ 注意事项

⚠️ 重要提示

• 确保所有API调用都包含有效的身份验证信息。
• 及时处理上传和下载过程中的异常情况。
• 定期检查许可证的有效性和更新状态。

📞 联系方式

• 技术支持：support@knowledgegraph.com
• 反馈提交：feedback@knowledgegraph.com
• 更多文档：https://docs.knowledgegraph.com