Back to MCP directory
publicPublicdnsLocal runtime

misskey-mcp-server

misskey-mcp-server是一个非官方的Misskey MCP(模型上下文协议)服务器,目前仅支持发布笔记等基础功能,期待社区贡献。

article

README

🚀 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
help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client