HTTP请求服务

一个支持多种HTTP方法和自定义配置的模型上下文协议服务器,适用于AI代理与Web API交互。

  • by jules-tnk
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 jules-tnk/ts-http-mcp

使用说明

HTTP MCP服务器

一种模型上下文协议(MCP)服务器,使AI代理能够向任何端点发送HTTP请求,并完全控制方法、标头、查询参数和请求体。

备注:此MCP服务器仅支持stdio传输。

LobeHub的MCP徽章

目录

特性

  • 支持主要HTTP方法(GET, POST, PUT, PATCH, DELETE, QUERY)
  • 自定义标头配置
  • 使用正确的URL编码处理查询参数
  • 请求对POST/PUT/PATCH/QUERY的主体支持
  • 全面的错误处理
  • 具有严格类型安全的TypeScript
  • 干净、模块化的架构
  • STDIO传输支持,可与MCP客户端无缝集成

安装

使用npm全局安装包:

npm install -g @jules-tnk/ts-http-mcp

或者使用npx直接运行它:

npx @jules-tnk/ts-http-mcp

配置

Claude 桌面版

将以下配置添加到Claude Desktop配置文件中(claude_desktop_config.json):

视窗: %APPDATA%\Claude\claude_desktop_config.json

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Linux: ~/.config/claude/claude_desktop_config.json

{
	"mcpServers": {
		"http-mcp": {
			"command": "npx",
			"args": ["@jules-tnk/ts-http-mcp"]
		}
	}
}

更新配置后,重新启动Claude Desktop以加载MCP服务器。

其他MCP客户端

对于支持stdio传输的其他MCP客户端,请将其配置为运行:

npx @jules-tnk/ts-http-mcp

本地开发

安装

pnpm install

构建

pnpm build

跑

pnpm start

测试

要在本地测试MCP服务器,您可以直接运行它并通过stdio与之交互:

pnpm start

服务器将启动并监听stdin/stdout上的MCP协议消息。

用法

一旦配置了MCP客户端,HTTP MCP服务器将提供以下功能:

  • GET请求:从任何HTTP端点检索数据
  • QUERY请求:使用请求体发送安全、幂等的请求
  • POST请求:向接受POST请求的端点发送数据
  • PUT/PATCH请求:更新远程服务器上的资源
  • 删除请求:从远程服务器中删除资源
  • 自定义头:添加身份验证、内容类型和其他标头
  • 查询参数:包含具有正确编码的URL参数
  • 请求机构:发送JSON、表单数据或支持body方法的原始内容

服务器处理所有HTTP通信细节、错误处理和响应处理,使AI代理能够轻松地与web API和服务进行交互。

许可证

MIT许可证-请参阅 许可证.md 文件以获取详细信息。