Tusky MCP Server 🦣

Tusky MCP 服务 🦣

用于将 Tusky 与 Claude 及其他兼容 MCP 的 AI 系统集成的模型上下文协议（MCP）服务。

什么是 Tusky MCP 服务？

Tusky MCP 服务在 Tusky 存储／Mastodon 集成与使用 模型上下文协议（MCP） 的 AI 助手之间搭建桥梁。借助标准化接口，Claude 和其他兼容的 AI 可以安全地访问和操作 Tusky 中的数据。

功能

• 使用 Tusky API 进行身份验证
• 管理 Tusky 保管库中的文件和文件夹
• 管理用户个人资料和存储
• 搜索功能：搜索保管库、文件夹和文件
• 使用 TUS 协议上传文件，实现可靠、可恢复的文件传输
• 与 Claude Desktop 和其他 MCP 客户端无缝集成

先决条件 🛠

开始之前，请确保已准备好：

• Tusky API 密钥（从 Tusky 账户获取）
• Node.js（v20 或更高版本）
• MCP 客户端，例如 Claude Desktop 或 Cursor

安装 🚀

1. 克隆此代码库：

git clone https://github.com/superposition/tusky-mcp-server.git
cd tusky-mcp-server

2. 安装依赖项：

npm install

3. 创建 .env 文件（从 .env.example 复制）：

cp .env.example .env

4. 在 .env 文件中填写 Tusky API 凭据：

TUSKY_API_KEY=your_api_key_here
TUSKY_API_URL=https://api.tusky.io/v1

5. 构建项目：

npm run build

运行服务 🖥️

使用以下命令启动服务：

npm start

开发时可使用自动重新加载：

npm run watch

功能文档

Tusky MCP 服务提供多个可通过兼容 MCP 的客户端使用的工具：

• 身份验证：连接到你的 Tusky 账户
• 保管库管理：创建、列出和修改存储保管库
• 文件夹管理：使用文件夹整理内容
• 文件管理：上传、下载和管理文件
• 搜索：搜索所有保管库和文件夹中的内容。查看搜索文档
• 文件上传：使用 TUS 协议上传文件，实现可靠、可恢复的文件传输。查看上传文档
• 用户个人资料：管理 Tusky 个人资料和设置

与 MCP 客户端集成

配置 Claude Desktop

macOS：

# Create the config file if it doesn't exist
touch "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# Open the config file in TextEdit
open -e "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

Windows：

code %APPDATA%\Claude\claude_desktop_config.json

添加服务配置：

{
  "mcpServers": {
    "tusky-mcp": {
      "command": "node",
      "args": ["/path/to/your/build/index.js"],
      "env": {
        "TUSKY_API_KEY": "your-api-key-here",
        "TUSKY_API_URL": "https://api.tusky.io/v1"
      }
    }
  }
}

配置 Cursor

1. 打开 Cursor 设置
2. 前往 Features > MCP Servers
3. 点击“+ Add New MCP Server”按钮
4. 填写以下信息：
   • 名称：输入服务的昵称（例如，“tusky-mcp”）
   • 类型：选择“command”作为类型
   • 命令：输入运行服务的命令：

     env TUSKY_API_KEY=your-api-key TUSKY_API_URL=https://api.tusky.io/v1 node /path/to/your/build/index.js
     

开发路线图

开发分为以下阶段：

1. 第 1 阶段 - 基础：基本 MCP 服务结构
2. 第 2 阶段 - 身份验证：身份验证质询和 API 密钥管理
3. 第 3 阶段 - 核心列表／检索：列出保管库和文件夹
4. 第 4 阶段 - 核心创建／修改：创建和修改保管库、文件夹及文件
5. 第 5 阶段 - 高级功能：文件上传、保管库共享和搜索功能
6. 第 6 阶段 - 基础设施：错误处理、响应格式化和测试

有关任务的详细拆分，请参阅 Issues 标签页。

贡献

欢迎为 Tusky MCP 服务贡献！更多信息请参阅贡献指南。

许可证

本项目采用 MIT License 许可。详情请参阅 LICENSE 文件。

致谢 🙏

• 感谢 模型上下文协议 提供 MCP 规范
• 感谢 Anthropic 提供 Claude Desktop
• 感谢 Tusky 团队打造出色的存储和 Mastodon 集成平台