MCP Ambassador

MCP大使


mcp-ambassador 是一个专门的MCP（多功能提供商）服务器，旨在协助AI代理发现其他相关的MCP服务器。

目的

代替自己执行搜索， mcp-ambassador 作为a 搜索指令生成器当人工智能代理（如聊天机器人或编码助理）识别出对与用户当前任务或对话上下文相关的工具的潜在需求时，它可以调用 mcp-ambassador.

大使分析请求（例如，“查找与FL Studio合作的工具”），并返回结构化指令，包括特定的搜索查询，告诉 *呼叫代理* 如何使用 *自己的* 网络搜索功能（如Brave search或Google search MCP），用于查找潜在相关的MCP服务器。

这使得主要的AI代理能够更有效地利用其现有的工具来发现针对用户即时需求量身定制的新MCP。

工作流程

1. 用户和主代理： 用户与他们的主要AI代理进行交互。
2. 需求识别（代理人）： 代理检测到一个主题（例如“使用Python进行数据分析”），其中专门的MCP工具可能会有所帮助，但代理目前无法使用。
3. 代理人致电大使： 代理人打电话给 mcp-ambassadors discover_servers 工具与a task_description （例如。， {"task_description": "Data analysis with Python"}).
4. 大使生成指令： 大使返回一个包含搜索查询的Markdown字符串（例如。， "MCP server for Data analysis with Python")以及代理人的说明。
5. 代理执行搜索： 代理使用其自己的可用网络搜索工具，执行提供的查询，并分析结果。
6. 代理人介绍调查结果： 代理总结了调查结果，并向用户推荐了潜在的MCP服务器。

安装

# Clone the repository
git clone https://github.com/WynnD/mcp-ambassador.git
cd mcp-ambassador

# Install dependencies
npm install

*（注：计划发布到npm，以便通过以下方式更容易安装 npm install mcp-ambassador)*

用法

运行服务器

您可以直接使用以下命令运行服务器 tsx （它实时处理TypeScript编译）：

npx tsx src/index.ts

这将启动MCP服务器，通过标准输入/输出进行监听(stdio).

向MCP客户端注册

将以下条目添加到MCP客户端的配置文件中（例如。， mcp.json)为了使其可被发现：

{
  "mcpServers": {
    "mcp-ambassador": {
      "command": "npx",
      // Adjust the path to where you cloned the repository
      "args": ["tsx", "/path/to/your/mcp-ambassador/src/index.ts"]
    }
    // ... other servers
  }
}

示例工具调用

AI代理会这样调用该工具（使用假设的MCP客户端）：

const result = await mcpClient.callTool('mcp-ambassador', 'discover_servers', {
  task_description: 'Working with FL Studio audio projects'
});
console.log(result);

输出示例

该工具将返回类似于以下内容的Markdown字符串：

### Action Required: Search for MCP Servers

I have identified a potential need related to "Working with FL Studio audio projects". To find relevant MCP servers, please perform the following actions using your available web search tool (e.g., `brave_web_search`, `google_search`):

1.  **Execute Search Query 1:**

MCP server for Working with FL Studio audio projects

2.  **(Optional) Execute Search Query 2 for broader results:**

Tools to help with Working with FL Studio audio projects

3.  **Analyze Results:** Look for results mentioning "MCP", specific tool names, or links to code repositories (like GitHub) that seem relevant to "Working with FL Studio audio projects".

**Note:** If you do not have a web search tool available, please inform the user and suggest installing one (e.g., Brave Search MCP).

发展

• 实施计划： 看 实施_计划.md 详细设计和未来计划。
• 装订/格式化： （如果使用ESLint/Pretier，请添加设置说明）
• 测试： （添加实施后运行测试的说明）

贡献

（如适用，添加捐款指南）

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息（如果你添加了一个）。