Misskey MCP Server

🚀 misskey-mcp-server 中文文檔

misskey-mcp-server 是一個 非官方 的 Misskey 平臺 MCP（模型上下文協議）服務器。當前僅具備 最基本的發佈筆記功能，歡迎各位貢獻者提交 PR 共同完善。

🚀 快速開始

安裝

使用 Go 安裝：

GOBIN="$HOME/go/bin" go install github.com/ganyariya/misskey-mcp-server/cmd/misskey-mcp-server@latest

自行構建：

git clone https://github.com/ganyariya/misskey-mcp-server
cd misskey-mcp-server
go build -o misskey-mcp-server cmd/misskey-mcp-server/main.go

配置

創建你的 mcp.json 文件，示例如下：

{
  "mcpServers": {
    "misskey-mcp-server": {
      "command": "misskey-mcp-server",
      "args": [],
      "env": {
        // 請參考 Misskey 開發文檔中的令牌配置
        "MISSKEY_API_TOKEN": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        // 協議選擇 http 或 https
        "MISSKEY_PROTOCOL": "https",
        // 你的 Misskey 服務域名
        "MISSKEY_DOMAIN": "misskey.io", 
        "MISSKEY_PATH": ""
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

✨ 主要特性

• [ ] notes
  • [x] 創建（發佈）一條筆記
• [ ] 其他待開發功能...

📚 詳細文檔

待辦事項

由於我對 Go 的掌握程度還不夠熟練，因此非常歡迎各位貢獻者提交 PR。

我將優先實現時間線、筆記和用戶的獲取/更新功能。至於管理員權限，出於安全考慮，可能不會進行實現...

• [ ] Vibe Coding 支持
  • [ ] 創建規則
  • [ ] 創建遊標規則
• [ ] 使用 GitHub Actions 實現 CI
• [ ] 使用 goreleaser 實現版本發佈
• [ ] 精細 Go 代碼結構
• [ ] 編寫 Go 測試用例
• [ ] 添加 docker-compose 支持，用於開發和配置 mcp.json
• [ ] 實現每個 API 工具
  • [ ] note
  • [ ] user
  • [ ] gallery
  • [ ] reaction
  • [ ] page
  • [ ] antenna
  • [ ] channel
  • [ ] federation
  • [ ] drive
  • [ ] notification

感謝參考的項目和庫

• MCP Go 實現
  • https://github.com/metoro-io/mcp-golang
• MCP 服務器參考
  • https://github.com/metoro-io/metoro-mcp-server
  • https://github.com/grafana/mcp-grafana
• Misskey Go API SDK
  • https://github.com/yitsushi/go-misskey