article
README
🚀 用于将Tusky与Claude和其他MCP兼容AI系统集成的模型上下文协议(MCP)服务器
本项目搭建了一座桥梁,连接Tusky存储/Mastodon集成与采用模型上下文协议(MCP)的AI助手。借助它,Claude等兼容AI能通过标准接口安全地访问和操作Tusky中的数据。
✨ 主要特性
- 支持使用Tusky API进行身份验证。
- 可对Tusky保险库中的文件和文件夹进行管理。
- 能管理用户配置文件和存储。
- 具备跨保险库、文件夹和文件的搜索功能。
- 采用TUS协议进行文件上传,确保实现可靠且可恢复的文件传输。
- 可与Claude Desktop和其他MCP客户端实现无缝集成。
📦 安装指南
先决条件 🛠️
在开始安装之前,请确保您已具备以下条件:
- 拥有Tusky API密钥(可从您的Tusky账户获取)。
- 安装了Node.js(版本需为v20或更高)。
- 准备好Claude Desktop或其他MCP客户端。
安装步骤 🚀
- 克隆此仓库:
git clone https://github.com/superposition/tusky-mcp-server.git
cd tusky-mcp-server
- 安装依赖项:
npm install
- 创建
.env文件(从.env.example复制):
cp .env.example .env
- 使用您的Tusky API凭证编辑
.env文件:
TUSKY_API_KEY=your_api_key_here
TUSKY_API_URL=https://api.tusky.io/v1
- 构建项目:
npm run build
💻 使用示例
运行服务器 🖥️
启动服务器
使用以下命令启动服务器:
npm start
开发模式(自动重新加载)
npm run watch
📚 详细文档
Tusky MCP Server 提供了多种工具,可通过兼容的MCP客户端使用:
- 身份验证:连接到您的Tusky账户。
- 保险库管理:创建、列出和修改存储保险库。
- 文件夹管理:通过文件夹组织内容。
- 文件管理:上传、下载和管理文件。
- 搜索:在所有保险库和文件夹中查找内容。查看搜索文档
- 文件上传:使用TUS协议进行可靠且可恢复的文件传输。查看上传文档
- 用户配置文件:管理您的Tusky配置文件和设置。
与MCP客户端集成
配置Claude Desktop
macOS系统
# 创建配置文件(如果不存在)
touch "$HOME/Library/Application Support/Claude/claude_desktop_config.json"
# 使用TextEdit打开配置文件
open -e "$HOME/Library/Application Support/Claude/claude_desktop_config.json"
Windows系统
原文档未给出Windows系统的具体配置命令,可根据实际情况补充。
Scan to join WeChat group