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客户端
安装🚀
- 克隆此存储库：
git clone https://github.com/superposition/tusky-mcp-server.git
cd tusky-mcp-server- 安装依赖项：
npm install- 创建一个
.env文件（复制自.env.example):
cp .env.example .env- 编辑
.env使用您的Tusky API证书提交文件：
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桌面
对于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"
}
}
}
}配置光标
- 打开光标设置
- 导航到功能>MCP服务器
- 点击“+添加新MCP服务器”按钮
- 填写以下信息：
- 名称：输入服务器的昵称（例如“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层-基础：基本MCP服务器结构
- 第2层-身份验证：Auth挑战和API密钥管理
- 第3层-核心列表/检索：Vault和文件夹列表
- 第4级-核心创建/修改：创建和修改Vault、文件夹、文件
- 第5层-高级功能：文件上传、vault共享、搜索功能
- 第6层-基础设施：错误处理、响应格式化、测试
有关详细的任务细分，请参阅“问题”选项卡。
贡献
我们欢迎对Tusky MCP服务器的贡献！请查看我们的 贡献指南 了解更多信息。
许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
致谢🙏
- 模型上下文协议 对于MCP规范
- 克劳德桌面的拟人化
- Tusky团队打造了出色的存储和Mastodon集成平台