AI导哈

Tusky MCP服务器

Tusky MCP服务器是一个连接Tusky存储/Mastodon集成与AI助手的桥梁，通过Model Context Protocol (MCP)实现Claude等兼容AI对Tusky数据的标准化访问和操作。

  • by superposition
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 superposition/tusky-mcp-server

使用说明

Tusky MCP服务器🦣

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

什么是Tusky MCP服务器？

Tusky MCP服务器使用 模型上下文协议（MCP）这使得Claude和其他兼容的AI能够通过标准化的接口安全地访问和操作Tusky中的数据。

特性

  • 使用Tusky API进行身份验证
  • Tusky保管库中的文件和文件夹管理
  • 用户配置文件和存储管理
  • 搜索功能 跨Vault、文件夹和文件
  • 使用TUS协议上传文件 用于可靠、可恢复的文件传输
  • 与Claude Desktop和其他MCP客户端无缝集成

先决条件🛠

在开始之前，请确保您已经：

  • Tusky API密钥（从您的Tusky帐户获取）
  • Node.js（v20或更高版本）
  • 像Claude Desktop或Cursor这样的MCP客户端

安装🚀

  1. 克隆此存储库：
git clone https://github.com/superposition/tusky-mcp-server.git
cd tusky-mcp-server
  1. 安装依赖项：
npm install
  1. 创建一个 .env 文件（复制自 .env.example):
cp .env.example .env
  1. 编辑 .env 使用您的Tusky API证书提交文件：
TUSKY_API_KEY=your_api_key_here
TUSKY_API_URL=https://api.tusky.io/v1
  1. 构建项目：
npm run build

运行服务器🖥️

使用以下命令启动服务器：

npm start

对于自动重新加载的开发：

npm run watch

功能文档

Tusky MCP Server提供了几个可以通过兼容的MCP客户端使用的工具：

  • 认证：连接到您的Tusky帐户
  • 保险库管理：创建、列出和修改存储库
  • 文件夹管理：使用文件夹组织内容
  • 文件管理：上传、下载和管理文件
  • 搜索：在所有保管库和文件夹中查找内容。 请参阅搜索文档
  • 文件上传：使用TUS协议上传文件，以实现可靠和可恢复的文件传输。 请参阅上传文档
  • 用户档案：管理您的Tusky个人资料和设置

与MCP客户端集成

配置Claude桌面

对于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"
      }
    }
  }
}

配置光标

  1. 打开光标设置
  2. 导航到功能>MCP服务器
  3. 点击“+添加新MCP服务器”按钮
  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层-身份验证：Auth挑战和API密钥管理
  3. 第3层-核心列表/检索：Vault和文件夹列表
  4. 第4级-核心创建/修改：创建和修改Vault、文件夹、文件
  5. 第5层-高级功能：文件上传、vault共享、搜索功能
  6. 第6层-基础设施：错误处理、响应格式化、测试

有关详细的任务细分，请参阅“问题”选项卡。

贡献

我们欢迎对Tusky MCP服务器的贡献！请查看我们的 贡献指南 了解更多信息。

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

致谢🙏

  • 模型上下文协议 对于MCP规范
  • 克劳德桌面的拟人化
  • Tusky团队打造了出色的存储和Mastodon集成平台

相关 MCP