🚀 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