使用说明

项目简介

Livecode MCP Server 是一个简单的 MCP 服务器实现，它集成了一个用于在 io.livecode.ch 平台上运行代码的工具。该服务器允许 LLM 客户端通过 MCP 协议调用预定义的工具，实现在 io.livecode.ch 上执行代码的功能。

主要功能点

工具注册与执行: 提供了一个名为 'run' 的工具，该工具允许客户端指定用户、仓库、代码和库，在 io.livecode.ch 上运行代码并返回结果。
基于 FastMCP 框架: 使用 'fastmcp' 库简化 MCP 服务器的开发。
Stdio 传输协议: 默认使用 Stdio 作为 MCP 客户端和服务器之间的通信协议。

安装步骤

安装 mcp 库 (如果尚未安装): 虽然仓库中没有明确说明，但根据 'README.md' 中的命令，推测可能需要安装 'mcp' 库。请查阅 'mcp' 库的官方文档进行安装。通常可以使用 pip 安装：
```
pip install mcp
```
安装 requests 库: 服务器代码依赖 'requests' 库来发送 HTTP 请求。如果尚未安装，请安装：
```
pip install requests
```
安装 uv (用于运行服务器): 客户端示例使用了 'uv run' 命令，这表明可能需要 'uv' 运行时环境来运行服务器。请根据 uv 官方文档进行安装配置。 https://docs.astral.sh/uv/

服务器配置

MCP 客户端需要配置服务器的启动命令和参数才能连接到 Livecode MCP Server。以下是基于 'cmdline_client.py' 提供的配置信息，以 JSON 格式呈现：

{
  "server name": "livecode-mcp-server",
  "command": "uv",
  "args": [
    "run",             # uv 运行命令
    "--with", "mcp",   # 引入 mcp 依赖
    "--with", "requests", # 引入 requests 依赖
    "mcp",             #  (推测) 可能用于指定运行环境或模块，具体作用需参考 mcp 库文档
    "run",             #  (推测) 可能用于指定运行模式或命令，具体作用需参考 mcp 库文档
    "server.py"        # 指定服务器启动脚本为 server.py
  ]
}

配置参数说明:

'server name': 服务器名称，客户端可以自定义，用于标识服务器连接。
'command': 启动服务器的命令，这里是 'uv'。
'args': 传递给 'command' 的参数列表，用于配置服务器的运行环境和启动脚本。
- 'run': uv 的运行子命令。
- '--with mcp': 指定 uv 运行时包含 'mcp' 依赖。
- '--with requests': 指定 uv 运行时包含 'requests' 依赖。
- 'mcp', 'run': 这两个参数的具体含义需要参考 'mcp' 库和 'uv' 的文档，推测可能与 'mcp' 框架的运行模式有关。
- 'server.py': 指定要运行的服务器脚本文件。

请注意: 以上配置是根据仓库内容推断，实际配置可能需要根据 'mcp' 库和 'uv' 的具体使用方式进行调整。建议查阅 'mcp' 和 'uv' 的官方文档以获得更准确的配置信息。

基本使用方法

启动 MCP 服务器: 根据上述服务器配置，使用 MCP 客户端配置的命令启动 'server.py'。例如，如果直接使用 'uv' 命令行，可以在终端中执行类似以下命令：
```
uv run --with mcp --with requests mcp run server.py
```
确保在包含 'server.py' 文件的目录下执行此命令。
配置并运行 MCP 客户端: 使用 MCP 客户端（例如 'cmdline_client.py'）连接到运行中的 MCP 服务器。 'cmdline_client.py' 示例代码展示了如何使用 Stdio 客户端连接到本地服务器，列出可用工具，并调用 'run' 工具。
调用 'run' 工具: 客户端可以通过 MCP 协议发送 JSON-RPC 请求来调用 'run' 工具，并传递必要的参数，例如 'user', 'repo', 'code', 'lib'。服务器将会在 io.livecode.ch 上执行代码，并将结果返回给客户端。

运行 'cmdline_client.py' 示例: 在配置好服务器并运行后，可以直接运行 'cmdline_client.py' 脚本来测试客户端与服务器的连接和工具调用：

python cmdline_client.py

预期输出会显示工具列表以及调用 'run' 工具的结果。

关键词