misskey-mcp-server

misskey-mcp-server

misskey-mcp-server は、Misskey 向けの非公式 MCP（Model Context Protocol）サーバーです。
現在の機能は、ノートの投稿という最小限のものだけです。
皆さんからの貢献（PR）をお待ちしています！

機能

MCP ツールの実装状況

MCP ツール名	Misskey API エンドポイント	状況
post_misskey_note	/notes/create	✅
get_misskey_note	/notes/show	❌
get_misskey_timeline	/notes/timeline	❌
get_misskey_user	/users/show	❌
get_misskey_user_notes	/users/notes	✅
get_misskey_user_following	/users/following	❌
get_misskey_user_followers	/users/followers	❌
get_misskey_notifications	/i/notifications	❌
get_misskey_mentions	/notes/mentions	❌
get_misskey_antenna	/antennas/show	❌
get_misskey_antenna_notes	/antennas/notes	❌
get_misskey_channel	/channels/show	❌
get_misskey_channel_notes	/channels/notes	❌
get_misskey_gallery	/gallery/posts/show	❌
get_misskey_gallery_posts	/gallery/posts	❌
get_misskey_page	/pages/show	❌
get_misskey_drive_files	/drive/files	❌
post_misskey_reaction	/notes/reactions/create	❌
delete_misskey_reaction	/notes/reactions/delete	❌
post_misskey_follow	/following/create	❌
delete_misskey_follow	/following/delete	❌
post_misskey_renote	/notes/create (renote)	❌
post_misskey_reply	/notes/create (reply)	❌
get_misskey_search	/notes/search	❌
get_misskey_search_by_tag	/notes/search-by-tag	❌
get_misskey_hashtags	/hashtags/trend	❌
get_misskey_emoji	/emojis	❌
get_misskey_meta	/meta	❌
get_misskey_instance	/federation/instances	❌
get_misskey_stats	/stats	❌

使い方

インストール

go install からインストール

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": {
        // 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": []
    }
  }
}

参考にしたプロジェクト

• 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

get_misskey_user_notes

特定の Misskey ユーザーのノートを取得します。

引数：

• userId （string、必須）：ノートを取得するユーザーの ID です。

リクエスト例：

{
  "userId": "some_user_id"
}