Home
MCP Servers
ganyariya
misskey-mcp-server

misskey-mcp-server

misskey-mcp-server is an unofficial Model Context Protocol server specifically designed for Misskey. It currently allows users to post notes and is open for contributions to enhance its features and functionality further.

GitHub stars GitHub forks GitHub issues GitHub pull requests GitHub license GitHub contributors GitHub last commit

misskey-mcp-server

misskey-mcp-server is an unofficial MCP (Model Context Protocol) server for Misskey.
Currently, it only has the bare minimum functionality: posting notes.
So, I would appreciate contributions (PRs) from everyone!

Features

notes
- create (post) a note
other wip...

Usage

Install

From go install

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

Build your own

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

Setup

Setup your mcp.json as below.

{
  "mcpServers": {
    "misskey-mcp-server": {
      "command": "misskey-mcp-server",
      "args": [],
      "env": {
        // https://misskey-hub.net/ja/docs/for-developers/api/token/
        "MISSKEY_API_TOKEN": "aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
        // http or https
        "MISSKEY_PROTOCOL": "https",
        // your misskey server's domain
        "MISSKEY_DOMAIN": "misskey.io", 
        "MISSKEY_PATH": ""
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

TODO

I'm not very familiar with Go myself.
I would appreciate contributions (PRs) from everyone!

I will prioritize implementing the fetching/updating of timelines, notes, and users.
Regarding administrator privileges, perhaps it's safer not to implement them...?

Thanks to reference

MCP Go Implementation
- https://github.com/metoro-io/mcp-golang
MCP Server References
- https://github.com/metoro-io/metoro-mcp-server
- https://github.com/grafana/mcp-grafana
Misskey Go API SDK
- https://github.com/yitsushi/go-misskey