MCP Web Tools Server

🚀 MCP 网络工具服务器

MCP 网络工具服务器是一个基于模型上下文协议（MCP）的服务器，它提供了一系列标准化的网络操作工具。借助该服务器，大型语言模型能够通过标准化工具与网络内容进行交互。

🚀 快速开始

此服务器允许大型语言模型与网络内容通过标准化工具进行交互，下面为你介绍其使用方法。

✨ 主要特性

• web_scrape：将 URL 使用 r.jina.ai 作为前缀，并返回 Markdown 格式的内容。

📦 安装指南

克隆仓库

git clone <repository-url>
cd MCP

安装依赖

你可以选择以下任意一种方式安装所需的依赖项：

pip install -r requirements.txt

或者，使用 uv 进行更快的安装：

uv pip install -r requirements.txt

💻 使用示例

运行服务器和 UI

使用运行脚本

• macOS/Linux

# 使用默认 stdio 传输运行服务器
./run.sh server

# 使用 SSE 传输运行服务器
./run.sh server --transport sse --host localhost --port 5000

# 运行 Streamlit 界面
./run.sh ui

• Windows

# 使用默认 stdio 传输运行服务器
run.bat server

# 使用 SSE 传输运行服务器
run.bat server --transport sse --host localhost --port 5000

# 运行 Streamlit 界面
run.bat ui

手动运行

• 使用 stdio（默认）

python server.py

• 使用 SSE

python server.py --transport sse --host localhost --port 5000

这将启动一个在 localhost:5000 运行的 HTTP 服务器，接受 MCP 连接。

• 手动运行 Streamlit 界面

streamlit run streamlit_app.py

使用 MCP 监视器测试

# 安装 MCP 监视器
npm install -g @modelcontextprotocol/inspector

# 运行监视器
inspector

在浏览器中打开 http://localhost:9000，然后粘贴服务器的 URL（例如 http://localhost:5000）并按回车。

与 Claude 集成

// 打开 Claude 的配置文件：%APPDATA%/Claude/Settings/settings.json
// 在 additionalEndpoints 中添加以下内容
"MCP Web Tools Server": {
  "url": "http://localhost:5000"
}

保存文件并重启 Claude。

添加更多工具

// 打开 tools.json
// 添加新工具的定义
{
  "name": "new_tool",
  "description": "描述新工具的功能",
  "parameters": [
    {
      "name": "param1",
      "type": "string",
      "description": "参数 1 的描述"
    }
  ]
}

保存文件并重新加载服务器。

运行 Streamlit 界面

streamlit run streamlit_app.py

这将启动一个 Web 浏览器，打开界面。您可以在界面上查看所有配置的 MCP 服务器及其工具，并执行测试。

📚 详细文档

故障排除

• 缺少依赖项：确保安装了 requirements.txt 中的所有依赖项。
• 连接问题：检查服务器是否在运行，并且 Claude 配置文件中的路径是否正确。
• 工具执行错误：查看服务器输出中的错误信息。
• Streamlit 界面问题：确保 Streamlit 已正确安装，并且配置文件路径正确。

📄 许可证

该项目根据 MIT 许可证提供。更多详细信息请参阅 LICENSE 文件。