使用说明

项目简介

Eagle.cool 仓库提供了一个 Model Context Protocol (MCP) 服务器的实现，名为 "Eagle MCP Server"。该服务器旨在作为 Eagle 应用程序和支持 MCP 协议的客户端（如 Claude Desktop）之间的桥梁。目前，它提供了一个简单的工具，用于检查 Eagle 应用程序的连接状态。

主要功能点

工具注册和执行: 实现了 MCP 服务器的核心功能，可以注册和执行工具。目前提供了一个名为 'eagle-status' 的工具。
状态检查工具: 'eagle-status' 工具允许 MCP 客户端查询 Eagle 应用程序的连接状态，并返回 "Connected" 表示已连接。
基于 Stdio 传输: 使用标准的 Stdio (标准输入/输出) 作为 MCP 服务器的传输协议，方便集成和部署。
使用 MCP SDK: 基于 '@modelcontextprotocol/sdk' 库构建，确保了与 MCP 协议的兼容性。

安装步骤

安装 Node.js 和 npm: 确保你的系统已安装 Node.js 和 npm (Node 包管理器)。

克隆仓库: 将 Eagle.cool 仓库克隆到本地：

git clone https://github.com/olegshilin/mcp-eagle.git
cd mcp-eagle

安装依赖: 在仓库目录下，运行以下命令安装项目依赖：
```
npm install
```
构建服务器: 运行以下命令构建服务器代码：
```
npm run build
```

服务器配置

要将 Eagle MCP Server 与 MCP 客户端（例如 Claude Desktop）配合使用，您需要在客户端中配置 MCP 服务器信息。以 Claude Desktop 为例，您需要编辑 Claude Desktop 的配置文件 'claude_desktop_config.json'，通常位于 '~/Library/Application Support/Claude/' 目录下 (macOS)。添加或修改 'mcpServers' 配置项，加入以下 JSON 配置：

{
  "mcpServers": {
    "eagle": {  //  服务器名称，可以自定义，在 Claude Desktop 中用于标识
      "command": "node",  //  启动服务器的命令，这里使用 node.js 运行时
      "args": ["/path/to/mcp-eagle/build/index.js"]  //  启动命令的参数，指向构建后的服务器入口文件。请将 "/path/to/mcp-eagle" 替换为实际的仓库路径
    }
  }
}

请注意: 将 '"/path/to/mcp-eagle"' 替换为您本地 'mcp-eagle' 仓库的实际绝对路径。您可以使用 'pwd' 命令在仓库根目录下获取当前路径。

基本使用方法

启动 Eagle MCP Server: 在 'mcp-eagle' 仓库目录下，运行以下命令启动服务器：
```
npm start
```
服务器将在后台运行，并通过 Stdio 与 MCP 客户端通信。您应该在终端看到 "Eagle MCP Server running on stdio" 的提示信息。
配置并启动 MCP 客户端: 根据 MCP 客户端 (例如 Claude Desktop) 的文档，配置并启动客户端，确保客户端已正确加载并连接到您配置的 "eagle" MCP 服务器。
使用 'eagle-status' 工具: 在 MCP 客户端中，您应该可以使用 'eagle-status' 工具来检查 Eagle 应用程序的连接状态。具体的使用方式取决于 MCP 客户端的界面和操作方式。通常，您可以在客户端的工具调用或类似功能中找到并执行 'eagle-status' 工具。执行后，客户端应该显示 "Connected" 的文本内容，表明 Eagle MCP Server 运行正常且工具调用成功。

注意: 此 MCP 服务器目前只提供了一个简单的 'eagle-status' 工具作为示例。要扩展其功能，您需要根据 MCP 协议规范，在 'src/index.ts' 文件中添加更多工具和资源的处理逻辑。

关键词