MCP 网络工具服务器

一个提供网络相关操作标准化工具的模型上下文协议（MCP）服务器。此服务器允许大型语言模型与网络内容通过标准化工具进行交互。

当前工具

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

安装

1. 克隆此仓库：

   git clone <repository-url>
   cd MCP
   

2. 安装所需的依赖项：

   pip install -r requirements.txt
   

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

   uv pip install -r requirements.txt
   

运行服务器和 UI

此仓库包含运行 MCP 服务器或 Streamlit 界面的方便脚本。

使用运行脚本

在 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 监视器是用于测试和调试 MCP 服务器的工具。您可以使用它来与您的服务器交互：

1. 安装 MCP 监视器：

   npm install -g @modelcontextprotocol/inspector
   

2. 运行监视器：

   inspector
   

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

与 Claude 集成

1. 打开 Claude 的配置文件：

   %APPDATA%/Claude/Settings/settings.json
   

2. 在 additionalEndpoints 中添加以下内容：

   "MCP Web Tools Server": {
     "url": "http://localhost:5000"
   }
   

3. 保存文件并重启 Claude。

添加更多工具

1. 打开 tools.json
2. 添加新工具的定义，例如：

   {
     "name": "new_tool",
     "description": "描述新工具的功能",
     "parameters": [
       {
         "name": "param1",
         "type": "string",
         "description": "参数 1 的描述"
       }
     ]
   }
   

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

运行 Streamlit 界面

要运行 Streamlit 界面：

streamlit run streamlit_app.py

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

故障排除

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

许可证

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