AI代理服务器

MCP代理基础

作为MCP（模型上下文协议）服务器公开的AI代理。

概述

该项目提供了一个AI驱动的代理，可以：

• 读取本地文件
• 从URL获取内容
• 总结内容
• 回答问题并执行任务

代理作为MCP服务器公开，使其可供任何兼容MCP的客户端（VS Code、Claude Desktop等）访问。

先决条件

• Python 3.13+
• 紫外线 -Python包管理器
• 无烟煤API键 -AI代理需要
• Node.js （可选）-使用Readability.js进行更好的URL内容提取

安装

uv sync

用法

运行代理（独立）

uv run main.py

作为MCP服务器运行

uv run python mcp_server.py

可用工具

MCP服务器公开了以下工具：

配置

VS Code

添加到 .vscode/mcp.json 在您的工作空间中：

{
  "servers": {
    "mcp-basic-agent": {
      "type": "stdio",
      "command": "uv",
      "args": ["run", "python", "mcp_server.py"],
      "cwd": "E:\\Programming\\MCP-Agent-Basic"
    }
  }
}

克劳德桌面版

添加到您的Claude Desktop配置中：

{
  "mcpServers": {
    "mcp-basic-agent": {
      "command": "uv",
      "args": ["run", "python", "mcp_server.py"],
      "cwd": "/path/to/MCP-Agent-Basic"
    }
  }
}

环境变量

在中设置API密钥 mcp_agent.secrets.yaml:

anthropic:
  api_key: "your-api-key-here"

或者作为环境变量：

• ANTHROPIC_API_KEY -适用于克劳德模特

故障排除

Node.js警告

如果你看到关于找不到Node.js的警告，fetch服务器将使用基于Python的文章提取，而不是Readability.js。这仍然有效，但可能会产生略有不同的结果。安装Node.js v10+以获得最佳的URL获取。

MCP协议问题

服务器登录到stderr，以避免干扰stdout上的MCP JSON-RPC协议。检查VS Code中的输出面板（从下拉列表中选择“MCP”）以获取调试信息。

参考

• MCP代理文件
• 模型上下文协议