返回 MCP 目录
public公开dns本地运行

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

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端