Misskey MCP Server

🚀 misskey-mcp-server

The misskey-mcp-server is an unofficial MCP (Model Context Protocol) server for the Misskey platform. Currently, it only has the most basic function: posting notes. Therefore, we warmly welcome contributors to submit PRs.

🚀 Quick Start

✨ Features

• [ ] notes
  • [x] Create (publish) a note
• [ ] Other features to be developed...

📦 Installation

Install using Go:

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

Build it yourself:

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

Configuration

Create your mcp.json file as follows:

{
  "mcpServers": {
    "misskey-mcp-server": {
      "command": "misskey-mcp-server",
      "args": [],
      "env": {
        // Please refer to the token configuration in the Misskey development documentation
        "MISSKEY_API_TOKEN": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        // Choose the protocol: http or https
        "MISSKEY_PROTOCOL": "https",
        // Your Misskey service domain name
        "MISSKEY_DOMAIN": "misskey.io", 
        "MISSKEY_PATH": ""
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

📚 Documentation

Since my proficiency in Go is not yet sufficient, we warmly welcome contributors to submit PRs.

I will prioritize implementing the functions of retrieving/updating timelines, notes, and users. As for administrator privileges, they may not be implemented for security reasons...

• [ ] Support for Vibe Coding
  • [ ] Create rules
  • [ ] Create cursor rules
• [ ] Implement CI using GitHub Actions
• [ ] Implement version releases using goreleaser
• [ ] Refine the Go code structure
• [ ] Write Go test cases
• [ ] Add docker-compose support for development and configuring mcp.json
• [ ] Implement each API tool
  • [ ] note
  • [ ] user
  • [ ] gallery
  • [ ] reaction
  • [ ] page
  • [ ] antenna
  • [ ] channel
  • [ ] federation
  • [ ] drive
  • [ ] notification

Thanks to the referenced projects and libraries

• MCP Go implementation
  • https://github.com/metoro-io/mcp-golang
• MCP server reference
  • https://github.com/metoro-io/metoro-mcp-server
  • https://github.com/grafana/mcp-grafana
• Misskey Go API SDK
  • https://github.com/yitsushi/go-misskey