MCP Server Plugin

🚀 JetBrains MCP 服務器插件

JetBrains MCP（模型上下文協議）服務器插件實現了大語言模型（LLMs）與 JetBrains IDE 的無縫集成。該插件提供了處理 MCP 請求的服務器端實現，還為自定義工具的實現提供了擴展點，能有效提升開發效率。

🚀 快速開始

先決條件

• 安裝 JetBrains MCP 代理
• 安裝 JetBrains IDE（如 IntelliJ IDEA、WebStorm 等）

✨ 主要特性

該插件提供了一個擴展點系統，允許第三方插件實現自己的 MCP 工具。

💻 使用示例

自定義工具實現

基礎用法

該插件允許開發者創建並註冊自定義的 MCP 工具，以下是具體步驟：

1. 創建自定義工具

創建一個繼承 AbstractMcpTool 的類：

class MyCustomTool : AbstractMcpTool<MyArgs>() {
    override val name: String = "myCustomTool"
    override val description: String = "描述你的工具的功能"

    override fun handle(project: Project, args: MyArgs): Response {
        // 在此處實現你的工具邏輯
        return Response.ok("結果")
    }
}

// 定義你的參數數據類
@Serializable
data class MyArgs(
    val param1: String,
    val param2: Int
)

2. 註冊你的工具

要註冊你的工具，請將其作為擴展添加到 plugin.xml 中：

<idea-plugin>
    <!-- 你的插件配置 -->
    <depends>com.intellij.mcpServer</depends>
    
    <extensions defaultExtensionNs="com.intellij.mcpServer">
        <mcpTool implementation="com.example.MyCustomTool"/>
    </extensions>
</idea-plugin>

3. 工具實現指南

你的工具實現應遵循以下指南：

• 工具名稱應描述性強，使用小寫字母和可選下劃線
• 為你的工具參數創建一個數據類，與預期的 JSON 輸入匹配
• 合適地使用 Response 類：
  • 成功操作時使用 Response(result)
  • 錯誤情況時使用 Response(error = message)
• 使用提供的 Project 實例來訪問 IDE 服務

📚 詳細文檔

如何發佈更新

1. 更新 settings.gradle.kts 以提供新版本
2. 在 Github 上創建發行版，發佈任務將自動觸發

貢獻指南

我們歡迎貢獻！請隨意提交 Pull Request。