Party Time MCP

🚀 Party Time MCP 服務器

Party Time MCP 服務器是一個簡單的 MCP 服務器，當被詢問當前時間時，會回覆 “It's Party Time”，為用戶帶來別樣的體驗。

🚀 快速開始

這是對 MCP 協議的簡單實現，服務器直接從標準輸入讀取並寫入到標準輸出。它註冊了一個名為 get-time 的單個工具，並在調用該工具時始終以 “It's Party Time” 響應。服務器實現了 MCP 協議，能夠處理 JSON - RPC 消息並適當回應。

📦 安裝指南

macOS 安裝說明

1. 構建可執行文件

首先構建可執行文件：

mix deps.get
mix escript.build

這將在項目目錄中創建一個名為 party_time_mcp 的可執行文件。 確保它有執行權限：

chmod +x ./party_time_mcp

2. 配置 Claude 桌面

1. 打開你的 Claude 配置文件：

nano ~/.config/claude/settings.json

2. 在文件末尾添加以下內容以啟用實驗性功能：

{
  "experimental_features": {
    "custom_mcp_server": true
  }
}

3. 保存並退出編輯器。

3. 啟動 Claude 桌面

啟動 Claude 桌面後，它將自動連接到您指定的 MCP 服務器。默認情況下，它會在 localhost:5001 上查找服務器。

💻 使用示例

測試

要驗證您的 MCP 服務器是否正常工作，可以運行以下命令：

curl -X POST http://localhost:5001 -H "Content-Type: application/json" -d '{"jsonrpc": "2.0", "method": "tools/list"}'

如果一切正常，您應該會看到類似以下的響應：

{
  "jsonrpc": "2.0",
  "result": ["get-time"],
  "id": "some-id"
}

🔧 技術細節

近期修復

通知處理

服務器已更新以正確處理 Claude 桌面發送的 notifications/initialized 消息。此消息由客戶端發送，以確認接收了 server/initialized 通知。 所做的更改：

• 添加了對 notifications/initialized 消息的支持
• 服務器現在正確處理此通知而不產生錯誤

JSON 解析錯誤

服務器已更新以修復在 Claude 桌面中出現的 JSON 解析錯誤。問題是由於服務器將日誌消息輸出到標準輸出，與 JSON 響應混在一起，導致 JSON 解析器困惑。 所做的更改：

• 禁用所有日誌記錄以避免干擾 JSON 輸出
• 只有乾淨的 JSON 響應現在發送到標準輸出
• 移除了重複的啟動消息
• 在每個 JSON 響應後添加換行符以提高解析效果

Mix.env() 錯誤修復

服務器已更新以修復運行時出現的 UndefinedFunctionError: function Mix.env/0 is undefined 錯誤。此問題是因為在 escript 中沒有可用的 Mix 模塊。 所做的更改：

• 用編譯時常量替換運行時的 Mix.env() 調用
• 服務器現在正確確定是否處於測試模式，而無需依賴於 Mix

📚 詳細文檔

故障排除

如果您遇到與 Party Time MCP 服務器相關的問題，請參考以下常見問題和解決方案：

UndefinedFunctionError: function Mix.env/0 is undefined

如果看到類似錯誤提示，則表示可執行文件構建有誤。此錯誤是因為在 escript 中沒有可用的 Mix 模塊。 解決方法：

mix escript.build

權限問題

如果嘗試運行可執行文件時出現權限被拒絕的錯誤，請賦予其執行權限：

chmod +x ./party_time_mcp

配置文件問題

如果服務器找不到或無法讀取配置文件，請檢查文件是否存在且具有正確的權限。

JSON 錯誤

如果您看到 JSON 解析錯誤，請確保輸入到服務器的消息是有效的 JSON - RPC 2.0 格式。服務器期望消息格式如下：

{
  "jsonrpc": "2.0",
  "id": "some-id",
  "method": "method-name",
  "params": {}
}

對於不需要響應的通知（無回覆的消息），應省略 id 字段：

{
  "jsonrpc": "2.0",
  "method": "notification-name"
}