Party Time MCP

派对时间MCP服务器

一个简单的MCP服务器，当被问及当前时间时，它会以“It’s Party Time”作为响应。

概述

这是一个MCP服务器的简单实现，它直接从stdin读取并写入stdout。它注册了一个名为 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.配置克劳德桌面

1. 打开您的Claude Desktop配置文件：

open -e ~/Library/Application\ Support/Claude/claude_desktop_config.json

1. 将以下内容添加到您的配置中（如果文件尚不存在，请使用此内容创建它）：

{
  "mcpServers": {
    "partytime": {
      "command": "/path/to/your/party_time_mcp",
      "args": []
    }
  }
}

替换 /path/to/your/party_time_mcp 带有可执行文件的实际路径。

1. 保存文件并重新启动Claude Desktop

3.测试您的服务器

1. 打开克劳德桌面
2. 问克劳德“现在几点了？”
3. 克劳德应该检测到你的工具，并回复“是聚会时间”

故障排除

• Claude Desktop找不到该工具：确保配置中的路径正确，并且文件具有执行权限
• 权限问题：你可能需要跑步 chmod +x ./party_time_mcp 如果可执行文件没有正确的权限
• 配置文件问题：确保JSON有效且格式正确
• 克劳德桌面重新启动：确保在更改配置后重新启动了Claude Desktop
• JSON解析错误：如果您看到诸如“JSON输入的意外结束”或“JSON后的意外非空白字符”之类的错误：

- 这可能是因为服务器将额外的文本与JSON响应一起输出到stdout - 确保您使用的是最新版本的服务器，该服务器通过将日志发送到stderr而不是stdout来修复此问题 - 服务器现在确保只将干净、格式正确的JSON发送到stdout - 如果您仍然看到这些错误，请查看Claude Desktop日志以了解更多详细信息

• Mix.env（）错误：如果您看到以下错误 function Mix.env/0 is undefined，这意味着可执行文件构建不正确。Mix模块在运行时在escrip中不可用。使用修复此问题的最新代码重新生成可执行文件。

调试

如果您遇到JSON错误，可以手动运行服务器以查看其输出：

./party_time_mcp

然后在另一个终端中，您可以向它发送测试JSON-RPC消息：

echo '{"jsonrpc":"2.0","id":"test-1","method":"tools/list"}' | ./party_time_mcp

您还可以测试其他消息类型：

# Initialize request
echo '{"jsonrpc":"2.0","id":0,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test-client","version":"0.1.0"}}}' | ./party_time_mcp

# Notifications/initialized message
echo '{"jsonrpc":"2.0","method":"notifications/initialized"}' | ./party_time_mcp

# Tools/call request
echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get-time","arguments":{}}}' | ./party_time_mcp

服务器架构

Party Time MCP服务器被设计为符合机器对话协议（MCP）。它处理以下消息类型：

• initialize：响应服务器功能、服务器信息和协议版本。还发送了一个 server/initialized 处理后的通知。
• notifications/initialized：处理客户端初始化通知（不需要响应）。
• tools/list：返回可用工具的列表。
• tools/call：执行指定的工具并返回结果。

服务器还包括对无效请求和未知方法的稳健错误处理。

MCP协议合规性

服务器按照中的规定实现MCP协议 模型上下文协议规范。它对所有消息都遵循JSON-RPC 2.0格式，并实现了所需的消息类型：

1. 初始化：服务器响应 initialize 消息及其功能，并发送 server/initialized 通知。
2. 工具发现：服务器响应 tools/list 提供可用工具列表。
3. 工具执行：服务器处理 tools/call 请求 get-time 工具。
4. 错误处理：服务器对无效请求、未知方法和其他错误情况返回适当的错误响应。

测试

服务器包括全面的测试，以确保其正常运行：

1. 服务器测试：测试服务器处理各种JSON-RPC消息的能力，包括：

- initialize 消息处理和响应验证 - notifications/initialized 消息处理 - tools/list 请求处理 - tools/call 请求执行“获取时间”工具

1. Hermes客户测试：测试服务器与Hermes客户端的兼容性，包括：

- 处理初始化请求和服务器/初始化通知 - 处理通知/初始化消息 - 对工具/列表请求的正确响应 - 正确执行工具/调用请求

1. JSON格式测试：确保所有JSON响应都按照JSON-RPC 2.0规范正确格式化。

要运行测试，请执行以下操作：

mix test

重建（如果需要）

如果需要进行更改和重建：

mix deps.get
mix escript.build

最近修复

通知处理

服务器已更新以正确处理 notifications/initialized 来自Claude Desktop的消息。此消息由客户端发送，以确认收到 server/initialized 通知。

所做的更改：

• 增加了对 notifications/initialized 消息
• 服务器现在可以正确处理此通知，而不会产生错误

JSON解析错误

服务器已更新，以修复Claude Desktop中的JSON解析错误。问题是服务器将日志消息与JSON响应一起输出到stdout，这混淆了Claude Desktop中的JSON解析器。

所做的更改：

• 禁用所有日志记录以避免干扰JSON输出
• 现在只有干净的JSON响应被发送到stdout
• 删除了重复的启动消息
• 在每个JSON响应后添加换行符，以便更好地解析

Mix.env（）错误修复

服务器已更新以修复 Mix.env() 以escript运行时发生的错误。问题是Mix模块在运行时在escrip中不可用。

所做的更改：

• 替换运行时间 Mix.env() 具有编译时模块属性的调用
• 服务器现在可以正确地确定它是否在测试模式下运行，而无需在运行时依赖Mix

故障排除

如果您遇到Party Time MCP服务器的问题，以下是一些常见问题和解决方案：

Mix.env() 错误

如果你看到一个错误，比如 UndefinedFunctionError: function Mix.env/0 is undefined，这意味着可执行文件构建不正确。Mix模块在运行时在escrip中不可用。使用最新代码重建可执行文件：

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"
}