项目简介

该项目是一个实现了Model Context Protocol (MCP) 的服务器应用,专注于提供与泰国车牌号码和出生日期相关的卜卦和运势信息。它通过标准化的MCP接口,将特定的卜卦逻辑封装成可供大型语言模型(LLM)客户端调用的工具。

主要功能点

  • 提供多种卜卦工具: 封装了根据出生日期(日/月/年)、出生星期、以及泰国车牌号码进行运势分析的功能。
  • MCP协议支持: 作为MCP服务器,可以通过JSON-RPC协议与兼容的LLM客户端进行通信。
  • 多种传输方式: 支持通过标准输入输出(Stdio)和Server-Sent Events (SSE) 两种方式与客户端连接。
  • 工具化能力: 将卜卦逻辑注册为MCP工具,使得LLM能够理解并调用这些功能来获取信息。

安装步骤

要安装并运行此MCP服务器,您需要Go语言环境(1.16或更高版本)。

  1. 使用 'go install' (推荐): 打开终端,运行以下命令:

    go install github.com/naruebaet/thai-plate-prophecy-go-mcp@latest

    这会将可执行文件安装到您的Go bin目录(通常在 '$GOPATH/bin' 或 '$HOME/go/bin')。请确保该目录已添加到您的系统PATH环境变量中。

  2. 克隆仓库并手动构建: 如果您想从源代码构建,可以克隆仓库并编译:

    git clone https://github.com/naruebaet/thai-plate-prophecy-go-mcp.git
    cd thai-plate-prophecy-go-mcp
    go build

    这会在当前目录下生成一个名为 'thai-plate-prophecy-mcp' (或 'thai-plate-prophecy-mcp.exe' 在Windows上) 的可执行文件。

服务器配置 (供MCP客户端使用)

MCP服务器通常由MCP客户端启动和管理。要让您的MCP客户端能够连接并使用此服务器,您需要在客户端的配置中(通常是一个 'mcp.json' 文件)添加该服务器的信息。以下是标准的配置格式,请根据您的客户端要求进行调整:

{
    "mcpServers": {
        "thai-plate-prophecy-mcp": { // 给服务器起一个客户端内部使用的名称
            "type": "stdio",        // 连接类型,该服务器支持 "stdio" 或 "sse" (如果使用SSE,command可能需要加--sse参数)
            "command": "thai-plate-prophecy-mcp", // 启动服务器的可执行文件名称
            "args": []              // 启动服务器时需要的命令行参数,例如 ["--sse"]
        }
    }
}

注意:

  • 'command' 的值应指向您安装的可执行文件路径或文件名,如果已添加到PATH,则只需文件名即可。
  • 如果需要以SSE模式启动服务器,某些客户端可能需要在 'args' 中添加 '--sse' 参数来传递给服务器可执行文件。

基本使用方法

  1. 启动MCP服务器: 根据您的安装方式,运行生成的可执行文件。如果您使用了 'go install',通常直接运行:

    thai-plate-prophecy-mcp

    如果您手动构建并在当前目录,则运行 './thai-plate-prophecy-mcp'。服务器启动后,会提示其运行模式 (Stdio或SSE)。

  2. 连接MCP客户端: 使用兼容的MCP客户端应用,根据您在客户端配置中设置的信息(参照上面的配置示例),连接到正在运行的MCP服务器。

  3. 通过客户端使用工具: 一旦客户端成功连接,它将发现此服务器提供的卜卦工具(如根据生日、星期或车牌号查询运势)。用户可以通过客户端界面或交互方式,调用这些工具并提供必要的参数(如生日日期、车牌号等)来获取卜卦结果。

信息

分类

AI与计算