Mcp Http

MCP Http Server

📋 项目概述

MCP Http Server 是一个基于 Python httpx 库实现的 Model Context Protocol（MCP）服务。它通过 REST API 支持 HTTP 请求操作，包括 GET、POST、PUT 和 DELETE 等多种方法，旨在简化与各种 Web API 的集成。

🚀 快速开始

依赖项

• Python 3.x
• httpx 库
• uv（推荐的包管理器）

安装和启动

克隆项目

git clone https://github.com/one-matrix/mcp-http.git
cd mcp-http

请将 one-matrix 替换为实际的用户名或项目 URL。

安装依赖项

使用 uv（推荐）：

uv pip install .

或使用 pip：

pip install .

启动服务

请在项目中添加实际的启动命令，例如 python server.py 或 uv run server.py。

🛠️ 可用工具

此服务提供以下用于 Web API 交互的核心工具：

1. http_get

• 说明： 向指定 URL 发起 GET 请求。
• 参数：
  • url (str)：目标 URL，例如 https://api.example.com/data。
  • params (dict, optional)：URL 查询参数字典。
• 返回： 状态码（int）和响应内容（str）。

2. http_post

• 说明： 向指定 URL 发起 POST 请求，可选择附带数据正文。
• 参数：
  • url (str)：目标 URL。
  • params (dict, optional)：URL 查询参数字典。
  • body (dict, optional)：JSON 请求正文的字典。
  • headers (dict, optional)：请求标头。默认包含 Content-Type: application/json。
• 返回： 状态码（int）和响应内容（str）。

3. http_put

• 说明： 向指定 URL 发起 PUT 请求，可选择附带数据正文。
• 参数：
  • url (str)：目标 URL。
  • params (dict, optional)：URL 查询参数字典。
  • body (dict, optional)：JSON 请求正文的字典。
  • headers (dict, optional)：请求标头。默认包含 Content-Type: application/json。
• 返回： 状态码（int）和响应内容（str）。

4. http_delete

• 说明： 向指定 URL 发起 DELETE 请求。
• 参数：
  • url (str)：目标 URL。
  • params (dict, optional)：URL 查询参数字典。
• 返回： 状态码（int）和响应内容（str）。

原文档将其描述为“状态码字符串”；通常，状态码是整数，响应内容也可能为空或仅包含简单的确认消息。为保持一致，已对此进行调整。

🤝 与 Claude Desktop 集成

你可以将此 MCP Http Server 与 Claude Desktop 集成。

方法 1：使用 uv 启动

将以下配置添加到你的 claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "mcp-httpx": {
      "command": "uv",
      "args": [
        "--from",
        "git+https://github.com/one-matrix/mcp-http", 
        "run",
        "mcp-http"
      ]
    }
  }
}

{
  "mcpServers": {
    "mcp-httpx": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/one-matrix/mcp-http", 
        "mcp-http" 
      ]
    }
  }
}

或者，你也可以安装：uv pip install mcp-http

{
  "mcpServers": {
    "mcp-httpx": {
      "command": "uv",
      "args": [
        "run",
        "-m",
        "mcp_http"
      ]
    }
  }
}

示例

📜 许可证

本项目采用 MIT License 开源。你可以自由使用、修改和分发此软件。具体条款请参阅项目仓库中的 LICENSE 文件。