jiazhizhong/higress
1
0
Fork 0
mirror of https://github.com/alibaba/higress.git synced 2026-03-17 00:40:48 +08:00
Code Issues Packages Projects Releases Wiki Activity

add mcp descriptions (#2080)

Browse Source
This commit is contained in:
mirror
2025-04-17 13:46:31 +08:00
committed by GitHub
parent 275cac9dbb
commit b13bce6a36
18 changed files with 3050 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

34
plugins/wasm-go/mcp-servers/mcp-bravesearch/README.md Normal file
View File

@@ -0,0 +1,34 @@
# Brave Search MCP Server
An MCP server implementation that integrates the Brave Search API, providing web and local search capabilities.
## Features
- **Web Search**: Supports general queries, news, articles, with pagination and time control
- **Local Search**: Find businesses, restaurants, and services with detailed information
Source code: [https://github.com/modelcontextprotocol/servers/tree/main/src/brave-search](https://github.com/modelcontextprotocol/servers/tree/main/src/brave-search)
# Usage Guide
## Get API-KEY
1. Register for a Brave Search API account [Visit official website](https://brave.com/search/api/)
2. Choose a plan (free plan includes 2000 queries per month)
3. Generate API key through developer console [Go to console](https://api.search.brave.com/app/keys)
## Generate SSE URL
On the MCP Server interface, log in and enter the API-KEY to generate the URL.
## Configure MCP Client
On the user's MCP Client interface, add the generated SSE URL to the MCP Server list.
```json
"mcpServers": {
"bravesearch": {
"url": "http://mcp.higress.ai/mcp-brave-search/{generate_key}",
}
}
```

38
plugins/wasm-go/mcp-servers/mcp-bravesearch/README_ZH.md Normal file
View File

@@ -0,0 +1,38 @@
# Brave Search MCP Server
一个集成Brave搜索API的MCP服务器实现，提供网页和本地搜索功能。
## 功能
- **网页搜索**：支持通用查询、新闻、文章，具备分页和时效性控制
- **本地搜索**：查找带有详细信息的企业、餐厅和服务
源码地址：[https://github.com/modelcontextprotocol/servers/tree/main/src/brave-search](https://github.com/modelcontextprotocol/servers/tree/main/src/brave-search)
# 使用教程
## 获取 API-KEY
1. 注册Brave搜索API账号 [访问官网](https://brave.com/search/api/)
2. 选择套餐（免费套餐每月包含2000次查询）
3. 通过开发者控制台生成 API 密钥 [前往控制台](https://api.search.brave.com/app/keys)
## 生成 SSE URL
在 MCP Server 界面，登录后输入 API-KEY，生成URL。
## 配置 MCP Client
在用户的 MCP Client 界面，将生成的 SSE URL添加到MCP Server列表中。
```json
"mcpServers": {
"bravesearch": {
"url": "http://mcp.higress.ai/mcp-brave-search/{generate_key}",
}
}
```

76
plugins/wasm-go/mcp-servers/mcp-bravesearch/mcp-server.yaml Normal file
View File

@@ -0,0 +1,76 @@
server:
name: brave-search-server
config:
apiKey: ""
tools:
- name: brave_web_search
description: "使用Brave Search API进行网页搜索，适用于一般查询、新闻、文章和在线内容。支持分页、内容过滤和新鲜度控制。每次请求最多返回20条结果。"
args:
- name: query
description: "搜索查询（最多400字符，50个词）"
type: string
required: true
- name: count
description: "结果数量（1-20，默认10）"
type: integer
required: false
default: 10
- name: offset
description: "分页偏移量（最大9，默认0）"
type: integer
required: false
default: 0
requestTemplate:
url: "https://api.search.brave.com/res/v1/web/search"
method: GET
argsToUrlParam: true
headers:
- key: Accept
value: "application/json"
- key: Accept-Encoding
value: "gzip"
- key: X-Subscription-Token
value: "{{.config.apiKey}}"
responseTemplate:
body: |
{{- range $index, $item := .web.results }}
## 结果 {{add $index 1}}
- **标题**: {{ $item.title }}
- **描述**: {{ $item.description }}
- **URL**: {{ $item.url }}
{{- end }}
- name: brave_local_search
description: "使用Brave的Local Search API搜索本地商家和地点。适用于与物理位置、商家、餐厅、服务等相关的查询。返回详细信息包括商家名称、地址、评分、评论数、电话号码、营业时间等。如果没有本地结果，会自动回退到网页搜索。"
args:
- name: query
description: "本地搜索查询（例如'Central Park附近的披萨'）"
type: string
required: true
- name: count
description: "结果数量（1-20，默认5）"
type: integer
required: false
default: 5
requestTemplate:
url: "https://api.search.brave.com/res/v1/web/search"
method: GET
argsToUrlParam: true
headers:
- key: Accept
value: "application/json"
- key: Accept-Encoding
value: "gzip"
- key: X-Subscription-Token
value: "{{.config.apiKey}}"
responseTemplate:
body: |
{{- range $index, $item := .results }}
## 结果 {{add $index 1}}
- **名称**: {{ $item.name }}
- **地址**: {{ $item.address.streetAddress }}, {{ $item.address.addressLocality }}, {{ $item.address.addressRegion }} {{ $item.address.postalCode }}
- **电话**: {{ $item.phone }}
- **评分**: {{ $item.rating.ratingValue }} ({{ $item.rating.ratingCount }} 条评论)
- **价格范围**: {{ $item.priceRange }}
- **营业时间**: {{ join $item.openingHours ", " }}
{{- end }}

27
plugins/wasm-go/mcp-servers/mcp-chatppt/README.md Normal file
View File

@@ -0,0 +1,27 @@
# ChatPPT MCP Server
Biyou Technology's MCP Server currently covers 18 intelligent document processing interfaces, including but not limited to PPT creation, PPT beautification, PPT generation, resume creation, resume analysis, and person-job matching. Users can build their own document creation tools through the server, enabling more possibilities for intelligent document creation.
Source code: [https://github.com/YOOTeam/chatppt-mcp](https://github.com/YOOTeam/chatppt-mcp)
## Usage Guide
### Get API-KEY
Refer to the official documentation to get API-KEY [Create Application and Get Token](https://wiki.yoo-ai.com/mcp/McpServe/serve1.3.html)
### Generate SSE URL
On the MCP Server interface, log in and enter the API-KEY to generate the URL.
### Configure MCP Client
On the user's MCP Client interface, add the generated SSE URL to the MCP Server list.
```json
"mcpServers": {
"chatppt": {
"url": "http://mcp.higress.ai/mcp-chatppt/{generate_key}",
}
}
```

28
plugins/wasm-go/mcp-servers/mcp-chatppt/README_ZH.md Normal file
View File

@@ -0,0 +1,28 @@
# ChatPPT MCP Server
必优科技 MCP Server 目前已经覆盖了 18 个智能文档的接口能力，包括但不限于 PPT 创作，PPT 美化，PPT 生成，简历创作，简历分析，人岗匹配等场景下的文档处理能力，用户可通过 server 搭建自己的文档创作工具，让智能文档创作有更多可能。
源码地址： [https://github.com/YOOTeam/chatppt-mcp](https://github.com/YOOTeam/chatppt-mcp)
## 使用教程
### 获取 API-KEY
参考官方文档获取 API-KEY [创建应用获取 Token](https://wiki.yoo-ai.com/mcp/McpServe/serve1.3.html)
### 生成 SSE URL
在 MCP Server 界面，登录后输入 API-KEY，生成URL。
### 配置 MCP Client
在用户的 MCP Client 界面，将生成的 SSE URL添加到 MCP Server列表中。
```json
"mcpServers": {
"chatppt": {
"url": "http://mcp.higress.ai/mcp-chatppt/{generate_key}",
}
}
```

121
plugins/wasm-go/mcp-servers/mcp-chatppt/mcp-server.yaml Normal file
View File

@@ -0,0 +1,121 @@
server:
name: chatppt-server
config:
apiKey: ""
tools:
- name: check
description: "查询用户当前配置token"
args: []
requestTemplate:
url: "https://saas.api.yoo-ai.com"
method: GET
headers:
- key: Authorization
value: "Bearer {{.config.apiKey}}"
responseTemplate:
body: |
{
"apiKey": "{{.body}}"
}
- name: query_ppt
description: "根据PPT任务ID查询异步生成结果"
args:
- name: ppt_id
description: "PPT-ID"
type: string
required: true
requestTemplate:
url: "https://saas.api.yoo-ai.com/apps/ppt-result"
method: GET
argsToUrlParam: true
headers:
- key: Authorization
value: "Bearer {{.config.apiKey}}"
responseTemplate:
body: |
{
"status": "{{.body.status}}",
"process_url": "{{.body.process_url}}"
}
- name: build_ppt
description: "根据描述的文本或markdown生成PPT"
args:
- name: text
description: "输入描述的文本或markdown"
type: string
required: true
requestTemplate:
url: "https://saas.api.yoo-ai.com/apps/ppt-create"
method: POST
argsToFormBody: true
headers:
- key: Authorization
value: "Bearer {{.config.apiKey}}"
responseTemplate:
body: |
{
"ppt_id": "{{.body}}"
}
- name: replace_template_ppt
description: "根据PPT-ID执行替换模板"
args:
- name: ppt_id
description: "PPT-ID"
type: string
required: true
requestTemplate:
url: "https://saas.api.yoo-ai.com/apps/ppt-create-task"
method: POST
argsToFormBody: true
headers:
- key: Authorization
value: "Bearer {{.config.apiKey}}"
responseTemplate:
body: |
{
"new_ppt_id": "{{.body}}"
}
- name: download_ppt
description: "生成PPT下载地址"
args:
- name: ppt_id
description: "PPT-ID"
type: string
required: true
requestTemplate:
url: "https://saas.api.yoo-ai.com/apps/ppt-download"
method: GET
argsToUrlParam: true
headers:
- key: Authorization
value: "Bearer {{.config.apiKey}}"
responseTemplate:
body: |
{
"download_url": "{{.body}}"
}
- name: editor_ppt
description: "生成PPT编辑器界面URL"
args:
- name: ppt_id
description: "PPT-ID"
type: string
required: true
requestTemplate:
url: "https://saas.api.yoo-ai.com/apps/ppt-editor"
method: POST
argsToFormBody: true
headers:
- key: Authorization
value: "Bearer {{.config.apiKey}}"
responseTemplate:
body: |
{
"editor_url": "{{.body}}"
}

33
plugins/wasm-go/mcp-servers/mcp-firecrawl/README.md Normal file
View File

@@ -0,0 +1,33 @@
# Firecrawl MCP Server
An implementation of the Model Context Protocol (MCP) server that integrates [Firecrawl](https://github.com/mendableai/firecrawl), providing web scraping capabilities.
## Features
- Supports scraping, crawling, searching, extracting, deep research, and batch scraping
- Supports JavaScript-rendered web page scraping
- URL discovery and crawling
- Web search and content extraction
- Scraping result transformation
## Usage Guide
### Get API-KEY
1. Register for a Firecrawl account [Visit official website](https://www.firecrawl.dev/app)
2. Generate API Key through developer console [Go to console](https://www.firecrawl.dev/app/api-keys)
### Generate SSE URL
On the MCP Server interface, log in and enter the API-KEY to generate the URL.
### Configure MCP Client
On the user's MCP Client interface, add the generated SSE URL to the MCP Server list.
```json
"mcpServers": {
"firecrawl": {
"url": "http://mcp.higress.ai/mcp-firecrawl/{generate_key}",
}
}
```

34
plugins/wasm-go/mcp-servers/mcp-firecrawl/README_ZH.md Normal file
View File

@@ -0,0 +1,34 @@
# Firecrawl MCP Server
一个集成了[Firecrawl](https://github.com/mendableai/firecrawl)的模型上下文协议（MCP）服务器实现，提供网页抓取功能。
## 功能
- 支持抓取、爬取、搜索、提取、深度研究和批量抓取
- 支持JavaScript渲染的网页抓取
- URL发现和爬取
- 网页搜索与内容提取
- 抓取结果转换
## 使用教程
### 获取 API-KEY
1. 注册Firecrawl 账号 [访问官网](https://www.firecrawl.dev/app)
2. 通过开发者控制台生成 API Key [前往控制台](https://www.firecrawl.dev/app/api-keys)
### 生成 SSE URL
在 MCP Server 界面，登录后输入 API-KEY，生成URL。
### 配置 MCP Client
在用户的 MCP Client 界面，将生成的 SSE URL添加到 MCP Server列表中。
```json
"mcpServers": {
"firecrawl": {
"url": "http://mcp.higress.ai/mcp-firecrawl/{generate_key}",
}
}
```

940
plugins/wasm-go/mcp-servers/mcp-firecrawl/mcp-server.yaml Normal file
View File

@@ -0,0 +1,940 @@
server:
config:
apiKey: ""
name: "rest-crawl-server"
tools:
- args:
- description: "要抓取的URL"
name: "url"
required: true
type: "string"
- default:
- "markdown"
description: "输出中包含的格式"
items:
enum:
- "markdown"
- "html"
- "rawHtml"
- "links"
- "screenshot"
- "screenshot@fullPage"
- "json"
type: "string"
name: "formats"
type: "array"
- default: true
description: "是否只返回主要内容"
name: "onlyMainContent"
type: "boolean"
- description: "输出中包含的标签"
items:
type: "string"
name: "includeTags"
type: "array"
- description: "输出中排除的标签"
items:
type: "string"
name: "excludeTags"
type: "array"
- description: "请求头信息"
name: "headers"
type: "object"
- default: 0
description: "抓取前的等待时间（毫秒）"
name: "waitFor"
type: "integer"
- default: false
description: "是否模拟移动设备"
name: "mobile"
type: "boolean"
- default: false
description: "是否跳过TLS验证"
name: "skipTlsVerification"
type: "boolean"
- default: 30000
description: "请求超时时间（毫秒）"
name: "timeout"
type: "integer"
- description: "JSON提取选项"
name: "jsonOptions"
properties:
prompt:
description: "提取提示"
type: "string"
schema:
description: "提取使用的schema"
type: "object"
systemPrompt:
description: "系统提示"
type: "string"
type: "object"
- description: "抓取前执行的操作"
items:
oneOf:
- properties:
milliseconds:
minimum: 1
type: "integer"
selector:
type: "string"
type:
enum:
- "wait"
type: "string"
type: "object"
- properties:
fullPage:
default: false
type: "boolean"
type:
enum:
- "screenshot"
type: "string"
type: "object"
- properties:
all:
default: false
type: "boolean"
selector:
type: "string"
type:
enum:
- "click"
type: "string"
type: "object"
- properties:
text:
type: "string"
type:
enum:
- "write"
type: "string"
type: "object"
- properties:
key:
type: "string"
type:
enum:
- "press"
type: "string"
type: "object"
- properties:
direction:
default: "down"
enum:
- "up"
- "down"
type: "string"
selector:
type: "string"
type:
enum:
- "scroll"
type: "string"
type: "object"
- properties:
type:
enum:
- "scrape"
type: "string"
type: "object"
- properties:
script:
type: "string"
type:
enum:
- "executeJavascript"
type: "string"
type: "object"
name: "actions"
type: "array"
- description: "位置设置"
name: "location"
properties:
country:
default: "US"
pattern: "^[A-Z]{2}$"
type: "string"
languages:
items:
type: "string"
type: "array"
type: "object"
- description: "是否移除base64图片"
name: "removeBase64Images"
type: "boolean"
- default: true
description: "是否启用广告拦截"
name: "blockAds"
type: "boolean"
- description: "使用的代理类型"
enum:
- "basic"
- "stealth"
name: "proxy"
type: "string"
description: "抓取单个URL并可选地使用LLM提取信息"
name: "scrape"
requestTemplate:
argsToJsonBody: true
headers:
- key: "Authorization"
value: "Bearer {{.config.apiKey}}"
method: "POST"
url: "https://api.firecrawl.dev/v1/scrape"
responseTemplate:
body: |
{{- if .success }}
成功: {{ .success }}
数据:
Markdown: {{ .data.markdown }}
HTML: {{ .data.html }}
Raw HTML: {{ .data.rawHtml }}
链接: {{ .data.links }}
截图: {{ .data.screenshot }}
元数据:
标题: {{ .data.metadata.title }}
描述: {{ .data.metadata.description }}
语言: {{ .data.metadata.language }}
源URL: {{ .data.metadata.sourceURL }}
状态码: {{ .data.metadata.statusCode }}
错误: {{ .data.metadata.error }}
{{- else }}
错误: {{ .error }}
{{- end }}
- args:
- description: "要抓取的URL列表"
items:
format: "uri"
type: "string"
name: "urls"
required: true
type: "array"
- description: "Webhook配置"
name: "webhook"
properties:
events:
description: "触发Webhook的事件类型"
items:
enum:
- "completed"
- "page"
- "failed"
- "started"
type: "string"
type: "array"
headers:
description: "Webhook请求头"
type: "object"
metadata:
description: "自定义元数据"
type: "object"
url:
description: "Webhook URL"
type: "string"
type: "object"
- default: false
description: "是否忽略无效URL"
name: "ignoreInvalidURLs"
type: "boolean"
- default:
- "markdown"
description: "输出中包含的格式"
items:
enum:
- "markdown"
- "html"
- "rawHtml"
- "links"
- "screenshot"
- "screenshot@fullPage"
- "json"
type: "string"
name: "formats"
type: "array"
- default: true
description: "是否只返回主要内容"
name: "onlyMainContent"
type: "boolean"
- description: "输出中包含的标签"
items:
type: "string"
name: "includeTags"
type: "array"
- description: "输出中排除的标签"
items:
type: "string"
name: "excludeTags"
type: "array"
- description: "请求头信息"
name: "headers"
type: "object"
- default: 0
description: "抓取前的等待时间（毫秒）"
name: "waitFor"
type: "integer"
- default: false
description: "是否模拟移动设备"
name: "mobile"
type: "boolean"
- default: false
description: "是否跳过TLS验证"
name: "skipTlsVerification"
type: "boolean"
- default: 30000
description: "请求超时时间（毫秒）"
name: "timeout"
type: "integer"
- description: "JSON提取选项"
name: "jsonOptions"
properties:
prompt:
description: "提取提示"
type: "string"
schema:
description: "提取使用的schema"
type: "object"
systemPrompt:
description: "系统提示"
type: "string"
type: "object"
- description: "抓取前执行的操作"
items:
oneOf:
- properties:
milliseconds:
minimum: 1
type: "integer"
selector:
type: "string"
type:
enum:
- "wait"
type: "string"
type: "object"
- properties:
fullPage:
default: false
type: "boolean"
type:
enum:
- "screenshot"
type: "string"
type: "object"
- properties:
all:
default: false
type: "boolean"
selector:
type: "string"
type:
enum:
- "click"
type: "string"
type: "object"
- properties:
text:
type: "string"
type:
enum:
- "write"
type: "string"
type: "object"
- properties:
key:
type: "string"
type:
enum:
- "press"
type: "string"
type: "object"
- properties:
direction:
default: "down"
enum:
- "up"
- "down"
type: "string"
selector:
type: "string"
type:
enum:
- "scroll"
type: "string"
type: "object"
- properties:
type:
enum:
- "scrape"
type: "string"
type: "object"
- properties:
script:
type: "string"
type:
enum:
- "executeJavascript"
type: "string"
type: "object"
name: "actions"
type: "array"
- description: "位置设置"
name: "location"
properties:
country:
default: "US"
pattern: "^[A-Z]{2}$"
type: "string"
languages:
items:
type: "string"
type: "array"
type: "object"
- description: "是否移除base64图片"
name: "removeBase64Images"
type: "boolean"
- default: true
description: "是否启用广告拦截"
name: "blockAds"
type: "boolean"
- description: "使用的代理类型"
enum:
- "basic"
- "stealth"
name: "proxy"
type: "string"
description: "批量抓取多个URL并可选地使用LLM提取信息"
name: "batch_scrape"
requestTemplate:
argsToJsonBody: true
headers:
- key: "Authorization"
value: "Bearer {{.config.apiKey}}"
method: "POST"
url: "https://api.firecrawl.dev/v1/batch/scrape"
responseTemplate:
body: |
{{- if .success }}
成功: {{ .success }}
任务ID: {{ .id }}
URL: {{ .url }}
无效URL: {{ .invalidURLs }}
{{- else }}
错误: {{ .error }}
{{- end }}
- args:
- description: "基础URL"
format: "uri"
name: "url"
required: true
type: "string"
- description: "搜索查询"
name: "search"
type: "string"
- default: true
description: "是否忽略网站地图"
name: "ignoreSitemap"
type: "boolean"
- default: false
description: "是否只返回网站地图中的链接"
name: "sitemapOnly"
type: "boolean"
- default: false
description: "是否包含子域名"
name: "includeSubdomains"
type: "boolean"
- default: 5000
description: "最大返回链接数"
maximum: 5000
name: "limit"
type: "integer"
- description: "超时时间（毫秒）"
name: "timeout"
type: "integer"
description: "根据选项映射多个URL"
name: "map"
requestTemplate:
argsToJsonBody: true
headers:
- key: "Authorization"
value: "Bearer {{.config.apiKey}}"
method: "POST"
url: "https://api.firecrawl.dev/v1/map"
responseTemplate:
body: |
{{- if .success }}
成功: {{ .success }}
链接: {{ .links }}
{{- else }}
错误: {{ .error }}
{{- end }}
- args:
- description: "要提取数据的URL"
items:
format: "uri"
type: "string"
name: "urls"
required: true
type: "array"
- description: "指导提取过程的提示"
name: "prompt"
type: "string"
- description: "定义提取数据结构的schema"
name: "schema"
properties:
property1:
description: "属性1的描述"
required: true
type: "string"
property2:
description: "属性2的描述"
required: true
type: "integer"
type: "object"
- default: false
description: "是否启用网络搜索"
name: "enableWebSearch"
type: "boolean"
- default: false
description: "是否忽略网站地图"
name: "ignoreSitemap"
type: "boolean"
- default: true
description: "是否包含子域名"
name: "includeSubdomains"
type: "boolean"
- default: false
description: "是否显示数据来源"
name: "showSources"
type: "boolean"
- description: "抓取选项"
name: "scrapeOptions"
properties:
actions:
description: "抓取前执行的操作"
items:
oneOf:
- properties:
milliseconds:
minimum: 1
type: "integer"
selector:
type: "string"
type:
enum:
- "wait"
type: "string"
type: "object"
- properties:
fullPage:
default: false
type: "boolean"
type:
enum:
- "screenshot"
type: "string"
type: "object"
- properties:
all:
default: false
type: "boolean"
selector:
type: "string"
type:
enum:
- "click"
type: "string"
type: "object"
- properties:
text:
type: "string"
type:
enum:
- "write"
type: "string"
type: "object"
- properties:
key:
type: "string"
type:
enum:
- "press"
type: "string"
type: "object"
- properties:
direction:
default: "down"
enum:
- "up"
- "down"
type: "string"
selector:
type: "string"
type:
enum:
- "scroll"
type: "string"
type: "object"
- properties:
type:
enum:
- "scrape"
type: "string"
type: "object"
- properties:
script:
type: "string"
type:
enum:
- "executeJavascript"
type: "string"
type: "object"
type: "array"
blockAds:
default: true
description: "是否启用广告拦截"
type: "boolean"
excludeTags:
description: "输出中排除的标签"
items:
type: "string"
type: "array"
formats:
default:
- "markdown"
description: "输出中包含的格式"
items:
enum:
- "markdown"
- "html"
- "rawHtml"
- "links"
- "screenshot"
- "screenshot@fullPage"
- "json"
type: "string"
type: "array"
headers:
description: "请求头信息"
type: "object"
includeTags:
description: "输出中包含的标签"
items:
type: "string"
type: "array"
jsonOptions:
description: "JSON提取选项"
properties:
prompt:
description: "提取提示"
type: "string"
schema:
description: "提取使用的schema"
type: "object"
systemPrompt:
description: "系统提示"
type: "string"
type: "object"
location:
description: "位置设置"
properties:
country:
default: "US"
pattern: "^[A-Z]{2}$"
type: "string"
languages:
items:
type: "string"
type: "array"
type: "object"
mobile:
default: false
description: "是否模拟移动设备"
type: "boolean"
onlyMainContent:
default: true
description: "是否只返回主要内容"
type: "boolean"
proxy:
description: "使用的代理类型"
enum:
- "basic"
- "stealth"
type: "string"
removeBase64Images:
description: "是否移除base64图片"
type: "boolean"
skipTlsVerification:
default: false
description: "是否跳过TLS验证"
type: "boolean"
timeout:
default: 30000
description: "请求超时时间（毫秒）"
type: "integer"
waitFor:
default: 0
description: "抓取前的等待时间（毫秒）"
type: "integer"
type: "object"
description: "使用LLM从页面中提取结构化数据"
name: "extract"
requestTemplate:
argsToJsonBody: true
headers:
- key: "Authorization"
value: "Bearer {{.config.apiKey}}"
method: "POST"
url: "https://api.firecrawl.dev/v1/extract"
responseTemplate:
body: |
{{- if .success }}
成功: {{ .success }}
任务ID: {{ .id }}
{{- else }}
错误: {{ .error }}
{{- end }}
- args:
- description: "搜索查询"
name: "query"
required: true
type: "string"
- default: 5
description: "最大返回结果数"
maximum: 10
minimum: 1
name: "limit"
type: "integer"
- description: "基于时间的搜索参数"
name: "tbs"
type: "string"
- default: "en"
description: "搜索结果的语言代码"
name: "lang"
type: "string"
- default: "us"
description: "搜索结果的国家代码"
name: "country"
type: "string"
- description: "搜索结果的location参数"
name: "location"
type: "string"
- default: 60000
description: "超时时间（毫秒）"
name: "timeout"
type: "integer"
- default: {}
description: "抓取搜索结果的选项"
name: "scrapeOptions"
properties:
formats:
default: []
description: "输出中包含的格式"
items:
enum:
- "markdown"
- "html"
- "rawHtml"
- "links"
- "screenshot"
- "screenshot@fullPage"
- "extract"
type: "string"
type: "array"
type: "object"
description: "搜索并可选地抓取搜索结果"
name: "search"
requestTemplate:
argsToJsonBody: true
headers:
- key: "Authorization"
value: "Bearer {{.config.apiKey}}"
method: "POST"
url: "https://api.firecrawl.dev/v1/search"
responseTemplate:
body: |
{{- if .success }}
成功: {{ .success }}
数据:
{{- range .data }}
- 标题: {{ .title }}
描述: {{ .description }}
URL: {{ .url }}
Markdown: {{ .markdown }}
HTML: {{ .html }}
Raw HTML: {{ .rawHtml }}
链接: {{ .links }}
截图: {{ .screenshot }}
元数据:
标题: {{ .metadata.title }}
描述: {{ .metadata.description }}
源URL: {{ .metadata.sourceURL }}
状态码: {{ .metadata.statusCode }}
错误: {{ .metadata.error }}
{{- end }}
警告: {{ .warning }}
{{- else }}
错误: {{ .error }}
{{- end }}
- args:
- description: "批量抓取任务的ID"
name: "id"
required: true
type: "string"
description: "获取批量抓取任务的状态"
name: "get_batch_scrape_status"
requestTemplate:
headers:
- key: "Authorization"
value: "Bearer {{.config.apiKey}}"
method: "GET"
url: "https://api.firecrawl.dev/v1/batch/scrape/{{.args.id}}"
responseTemplate:
body: |
{{- if .status }}
状态: {{ .status }}
总数: {{ .total }}
已完成: {{ .completed }}
使用信用: {{ .creditsUsed }}
过期时间: {{ .expiresAt }}
数据:
{{- range .data }}
- Markdown: {{ .markdown }}
HTML: {{ .html }}
Raw HTML: {{ .rawHtml }}
链接: {{ .links }}
截图: {{ .screenshot }}
元数据:
标题: {{ .metadata.title }}
描述: {{ .metadata.description }}
语言: {{ .metadata.language }}
源URL: {{ .metadata.sourceURL }}
状态码: {{ .metadata.statusCode }}
错误: {{ .metadata.error }}
{{- end }}
{{- else }}
错误: {{ .error }}
{{- end }}
- args:
- description: "批量抓取任务的ID"
name: "id"
required: true
type: "string"
description: "获取批量抓取任务的错误信息"
name: "get_batch_scrape_errors"
requestTemplate:
headers:
- key: "Authorization"
value: "Bearer {{.config.apiKey}}"
method: "GET"
url: "https://api.firecrawl.dev/v1/batch/scrape/{{.args.id}}/errors"
responseTemplate:
body: |
{{- if .errors }}
错误:
{{- range .errors }}
- ID: {{ .id }}
时间戳: {{ .timestamp }}
URL: {{ .url }}
错误信息: {{ .error }}
{{- end }}
被robots.txt阻止的URL:
{{- range .robotsBlocked }}
- {{ . }}
{{- end }}
{{- else }}
错误: {{ .error }}
{{- end }}
- args:
- description: "爬取任务的ID"
name: "id"
required: true
type: "string"
description: "获取爬取任务的状态"
name: "get_crawl_status"
requestTemplate:
headers:
- key: "Authorization"
value: "Bearer {{.config.apiKey}}"
method: "GET"
url: "https://api.firecrawl.dev/v1/crawl/{{.args.id}}"
responseTemplate:
body: |
{{- if .status }}
状态: {{ .status }}
总数: {{ .total }}
已完成: {{ .completed }}
使用信用: {{ .creditsUsed }}
过期时间: {{ .expiresAt }}
数据:
{{- range .data }}
- Markdown: {{ .markdown }}
HTML: {{ .html }}
Raw HTML: {{ .rawHtml }}
链接: {{ .links }}
截图: {{ .screenshot }}
元数据:
标题: {{ .metadata.title }}
描述: {{ .metadata.description }}
语言: {{ .metadata.language }}
源URL: {{ .metadata.sourceURL }}
状态码: {{ .metadata.statusCode }}
错误: {{ .metadata.error }}
{{- end }}
{{- else }}
错误: {{ .error }}
{{- end }}
- args:
- description: "爬取任务的ID"
name: "id"
required: true
type: "string"
description: "获取爬取任务的错误信息"
name: "get_crawl_errors"
requestTemplate:
headers:
- key: "Authorization"
value: "Bearer {{.config.apiKey}}"
method: "GET"
url: "https://api.firecrawl.dev/v1/crawl/{{.args.id}}/errors"
responseTemplate:
body: |
{{- if .errors }}
错误:
{{- range .errors }}
- ID: {{ .id }}
时间戳: {{ .timestamp }}
URL: {{ .url }}
错误信息: {{ .error }}
{{- end }}
被robots.txt阻止的URL:
{{- range .robotsBlocked }}
- {{ . }}
{{- end }}
{{- else }}
错误: {{ .error }}
{{- end }}
- args:
- description: "提取任务的ID"
name: "id"
required: true
type: "string"
description: "获取提取任务的状态"
name: "get_extract_job_status"
requestTemplate:
headers:
- key: "Authorization"
value: "Bearer {{.config.apiKey}}"
method: "GET"
url: "https://api.firecrawl.dev/v1/extract/{{.args.id}}"
responseTemplate:
body: |
{{- if .success }}
成功: {{ .success }}
数据: {{ .data }}
状态: {{ .status }}
过期时间: {{ .expiresAt }}
{{- else }}
错误: {{ .error }}
{{- end }}

39
plugins/wasm-go/mcp-servers/mcp-github/README.md Normal file
View File

@@ -0,0 +1,39 @@
# GitHub MCP Server
An MCP server implementation of the GitHub API, supporting file operations, repository management, search, and more.
Source code: [https://github.com/modelcontextprotocol/servers/tree/main/src/github](https://github.com/modelcontextprotocol/servers/tree/main/src/github)
## Features
- **Automatic branch creation**: Automatically creates branches if they don't exist when creating/updating files or pushing changes
- **Comprehensive error handling**: Provides clear error messages for common issues
- **Git history preservation**: Operations preserve complete Git history, no force pushing
- **Batch operations**: Supports both single file and batch file operations
- **Advanced search**: Supports code, issues/PRs, and user search
## Usage Guide
### Get AccessToken
[Create GitHub personal access token](https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens):
1. Visit [Personal access tokens](https://github.com/settings/tokens) (in GitHub Settings > Developer settings)
2. Select repositories the token can access (public, all, or selected)
3. Create token with `repo` permissions ("Full control of private repositories")
- Or, if only using public repositories, select only `public_repo` permissions
4. Copy the generated token
### Generate SSE URL
On the MCP Server interface, log in and enter the AccessToken to generate the URL.
### Configure MCP Client
On the user's MCP Client interface, add the generated SSE URL to the MCP Server list.
```json
"mcpServers": {
"github": {
"url": "http://mcp.higress.ai/mcp-github/{generate_key}",
}
}
```

40
plugins/wasm-go/mcp-servers/mcp-github/README_ZH.md Normal file
View File

@@ -0,0 +1,40 @@
# GitHub MCP Server
GitHub API 的 MCP 服务器实现，支持文件操作、仓库管理、搜索等功能。
源码地址：[https://github.com/modelcontextprotocol/servers/tree/main/src/github](https://github.com/modelcontextprotocol/servers/tree/main/src/github)
## 功能
- **自动分支创建**: 在创建/更新文件或推送更改时，如果分支不存在会自动创建
- **全面的错误处理**: 提供常见问题的清晰错误信息
- **Git 历史保留**: 操作会保留完整的 Git 历史记录，不会强制推送
- **批量操作**: 支持单文件和批量文件操作
- **高级搜索**: 支持代码、issues/PRs 和用户的搜索
## 使用教程
### 获取 AccessToken
[创建 GitHub 个人访问令牌](https://docs.github.com/zh/authentication/keeping-your-account-and-data-secure/managing-your-personal-access-tokens):
1. 访问 [个人访问令牌](https://github.com/settings/tokens)（在 GitHub 设置 > 开发者设置中）
2. 选择该令牌可以访问的仓库（公开、所有或选择）
3. 创建具有 `repo` 权限的令牌（"对私有仓库的完全控制"）
- 或者，如果仅使用公开仓库，选择仅 `public_repo` 权限
4. 复制生成的令牌
### 生成 SSE URL
在 MCP Server 界面，登录后输入 AccessToken，生成URL。
### 配置 MCP Client
在用户的 MCP Client 界面，将生成的 SSE URL添加到 MCP Server列表中。
```json
"mcpServers": {
"github": {
"url": "http://mcp.higress.ai/mcp-github/{generate_key}",
}
}
```

998
plugins/wasm-go/mcp-servers/mcp-github/mcp-server.yaml Normal file
View File

@@ -0,0 +1,998 @@
server:
name: github-mcp-server
config:
accessToken: ""
tools:
- name: create_or_update_file
description: 在GitHub仓库创建或更新单个文件
args:
- name: owner
type: string
required: true
description: "Repository owner (username or organization)"
- name: repo
type: string
required: true
description: "Repository name"
- name: path
type: string
required: true
description: "Path where to create/update the file"
- name: content
type: string
required: true
description: "Content of the file"
- name: message
type: string
required: true
description: "Commit message"
- name: branch
type: string
required: true
description: "Branch to create/update the file in"
- name: sha
type: string
required: false
description: "SHA of the file being replaced (required when updating existing files)"
requestTemplate:
url: "https://api.github.com/repos/{{.args.owner}}/{{.args.repo}}/contents/{{.args.path}}"
method: PUT
body: |
{
"message": "{{.args.message}}",
"content": "{{.args.content | b64enc}}",
"branch": "{{.args.branch}}",
"sha": "{{.args.sha}}"
}
headers:
- key: Authorization
value: "Bearer {{.config.accessToken}}"
- key: Accept
value: "application/vnd.github+json"
- key: X-GitHub-Api-Version
value: "2022-11-28"
- name: search_repositories
description: 搜索GitHub仓库
args:
- name: query
type: string
required: true
description: "Search query (see GitHub search syntax)"
- name: page
type: number
required: false
description: "Page number for pagination (default: 1)"
- name: perPage
type: number
required: false
description: "Number of results per page (default: 30, max: 100)"
requestTemplate:
url: "https://api.github.com/search/repositories?q={{.args.query}}&page={{.args.page}}&per_page={{.args.perPage}}"
method: GET
headers:
- key: Authorization
value: "Bearer {{.config.accessToken}}"
- key: Accept
value: "application/vnd.github+json"
- key: X-GitHub-Api-Version
value: "2022-11-28"
- name: create_repository
description: 在您的账户中创建新的GitHub仓库
args:
- name: name
type: string
required: true
description: "Repository name"
- name: description
type: string
required: false
description: "Repository description"
- name: private
type: boolean
required: false
description: "Whether the repository should be private"
- name: autoInit
type: boolean
required: false
description: "Initialize with README.md"
requestTemplate:
url: "https://api.github.com/user/repos"
method: POST
body: |
{
"name": "{{.args.name}}",
"description": "{{.args.description}}",
"private": {{.args.private}},
"auto_init": {{.args.autoInit}}
}
headers:
- key: Authorization
value: "Bearer {{.config.accessToken}}"
- key: Accept
value: "application/vnd.github+json"
- key: X-GitHub-Api-Version
value: "2022-11-28"
- name: get_file_contents
description: 从GitHub仓库获取文件或目录内容
args:
- name: owner
type: string
required: true
description: "Repository owner (username or organization)"
- name: repo
type: string
required: true
description: "Repository name"
- name: path
type: string
required: true
description: "Path to the file or directory"
- name: branch
type: string
required: false
description: "Branch to get contents from"
requestTemplate:
url: "https://api.github.com/repos/{{.args.owner}}/{{.args.repo}}/contents/{{.args.path}}?ref={{.args.branch}}"
method: GET
headers:
- key: Authorization
value: "Bearer {{.config.accessToken}}"
- key: Accept
value: "application/vnd.github+json"
- key: X-GitHub-Api-Version
value: "2022-11-28"
- name: push_files
description: 在单个提交中推送多个文件到GitHub仓库
args:
- name: owner
type: string
required: true
description: "Repository owner (username or organization)"
- name: repo
type: string
required: true
description: "Repository name"
- name: branch
type: string
required: true
description: "Branch to push to (e.g., 'main' or 'master')"
- name: files
type: array
items:
type: object
properties:
path:
type: string
content:
type: string
required: true
description: "Array of files to push"
- name: message
type: string
required: true
description: "Commit message"
requestTemplate:
url: "https://api.github.com/repos/{{.args.owner}}/{{.args.repo}}/git/commits"
method: POST
body: |
{
"message": "{{.args.message}}",
"tree": "{{.args.files | toJson}}",
"parents": ["{{.args.branch}}"]
}
headers:
- key: Authorization
value: "Bearer {{.config.accessToken}}"
- key: Accept
value: "application/vnd.github+json"
- key: X-GitHub-Api-Version
value: "2022-11-28"
- name: create_issue
description: 在GitHub仓库创建新Issue
args:
- name: owner
type: string
required: true
description: "Repository owner (username or organization)"
- name: repo
type: string
required: true
description: "Repository name"
- name: title
type: string
required: true
description: "Issue title"
- name: body
type: string
required: false
description: "Issue description"
- name: assignees
type: array
items:
type: string
required: false
description: "Usernames to assign"
- name: labels
type: array
items:
type: string
required: false
description: "Labels to add"
- name: milestone
type: number
required: false
description: "Milestone number"
requestTemplate:
url: "https://api.github.com/repos/{{.args.owner}}/{{.args.repo}}/issues"
method: POST
body: |
{
"title": "{{.args.title}}",
"body": "{{.args.body}}",
"assignees": {{.args.assignees | toJson}},
"labels": {{.args.labels | toJson}},
"milestone": {{.args.milestone}}
}
headers:
- key: Authorization
value: "Bearer {{.config.accessToken}}"
- key: Accept
value: "application/vnd.github+json"
- key: X-GitHub-Api-Version
value: "2022-11-28"
- name: create_pull_request
description: 在GitHub仓库创建新的Pull Request
args:
- name: owner
type: string
required: true
description: "Repository owner (username or organization)"
- name: repo
type: string
required: true
description: "Repository name"
- name: title
type: string
required: true
description: "Pull request title"
- name: body
type: string
required: false
description: "Pull request body/description"
- name: head
type: string
required: true
description: "The name of the branch where your changes are implemented"
- name: base
type: string
required: true
description: "The name of the branch you want the changes pulled into"
- name: draft
type: boolean
required: false
description: "Whether to create the pull request as a draft"
- name: maintainer_can_modify
type: boolean
required: false
description: "Whether maintainers can modify the pull request"
requestTemplate:
url: "https://api.github.com/repos/{{.args.owner}}/{{.args.repo}}/pulls"
method: POST
body: |
{
"title": "{{.args.title}}",
"body": "{{.args.body}}",
"head": "{{.args.head}}",
"base": "{{.args.base}}",
"draft": {{.args.draft}},
"maintainer_can_modify": {{.args.maintainer_can_modify}}
}
headers:
- key: Authorization
value: "Bearer {{.config.accessToken}}"
- key: Accept
value: "application/vnd.github+json"
- key: X-GitHub-Api-Version
value: "2022-11-28"
- name: fork_repository
description: 将GitHub仓库fork到您的账户或指定组织
args:
- name: owner
type: string
required: true
description: "Repository owner (username or organization)"
- name: repo
type: string
required: true
description: "Repository name"
- name: organization
type: string
required: false
description: "Optional: organization to fork to (defaults to your personal account)"
requestTemplate:
url: "https://api.github.com/repos/{{.args.owner}}/{{.args.repo}}/forks"
method: POST
body: |
{
"organization": "{{.args.organization}}"
}
headers:
- key: Authorization
value: "Bearer {{.config.accessToken}}"
- key: Accept
value: "application/vnd.github+json"
- key: X-GitHub-Api-Version
value: "2022-11-28"
- name: create_branch
description: 在GitHub仓库创建新分支
args:
- name: owner
type: string
required: true
description: "Repository owner (username or organization)"
- name: repo
type: string
required: true
description: "Repository name"
- name: branch
type: string
required: true
description: "Name for the new branch"
- name: from_branch
type: string
required: false
description: "Optional: source branch to create from (defaults to the repository's default branch)"
requestTemplate:
url: "https://api.github.com/repos/{{.args.owner}}/{{.args.repo}}/git/refs"
method: POST
body: |
{
"ref": "refs/heads/{{.args.branch}}",
"sha": "{{.args.from_branch}}"
}
headers:
- key: Authorization
value: "Bearer {{.config.accessToken}}"
- key: Accept
value: "application/vnd.github+json"
- key: X-GitHub-Api-Version
value: "2022-11-28"
- name: list_commits
description: 获取GitHub仓库分支的提交列表
args:
- name: owner
type: string
required: true
description: "Repository owner (username or organization)"
- name: repo
type: string
required: true
description: "Repository name"
- name: page
type: number
required: false
description: "Page number for pagination"
- name: perPage
type: number
required: false
description: "Number of results per page"
- name: sha
type: string
required: false
description: "Branch name"
requestTemplate:
url: "https://api.github.com/repos/{{.args.owner}}/{{.args.repo}}/commits?page={{.args.page}}&per_page={{.args.perPage}}&sha={{.args.sha}}"
method: GET
headers:
- key: Authorization
value: "Bearer {{.config.accessToken}}"
- key: Accept
value: "application/vnd.github+json"
- key: X-GitHub-Api-Version
value: "2022-11-28"
- name: list_issues
description: 列出并过滤GitHub仓库的Issues
args:
- name: owner
type: string
required: true
description: "Repository owner (username or organization)"
- name: repo
type: string
required: true
description: "Repository name"
- name: state
type: string
required: false
description: "Filter by state ('open', 'closed', 'all')"
- name: labels
type: array
items:
type: string
required: false
description: "Filter by labels"
- name: sort
type: string
required: false
description: "Sort by ('created', 'updated', 'comments')"
- name: direction
type: string
required: false
description: "Sort direction ('asc', 'desc')"
- name: since
type: string
required: false
description: "Filter by date (ISO 8601 timestamp)"
- name: page
type: number
required: false
description: "Page number"
- name: per_page
type: number
required: false
description: "Results per page"
requestTemplate:
url: "https://api.github.com/repos/{{.args.owner}}/{{.args.repo}}/issues?state={{.args.state}}&labels={{.args.labels | join ','}}&sort={{.args.sort}}&direction={{.args.direction}}&since={{.args.since}}&page={{.args.page}}&per_page={{.args.per_page}}"
method: GET
headers:
- key: Authorization
value: "Bearer {{.config.accessToken}}"
- key: Accept
value: "application/vnd.github+json"
- key: X-GitHub-Api-Version
value: "2022-11-28"
- name: update_issue
description: 更新GitHub仓库中的现有Issue
args:
- name: owner
type: string
required: true
description: "Repository owner (username or organization)"
- name: repo
type: string
required: true
description: "Repository name"
- name: issue_number
type: number
required: true
description: "Issue number to update"
- name: title
type: string
required: false
description: "New title"
- name: body
type: string
required: false
description: "New description"
- name: state
type: string
required: false
description: "New state ('open' or 'closed')"
- name: labels
type: array
items:
type: string
required: false
description: "New labels"
- name: assignees
type: array
items:
type: string
required: false
description: "New assignees"
- name: milestone
type: number
required: false
description: "New milestone number"
requestTemplate:
url: "https://api.github.com/repos/{{.args.owner}}/{{.args.repo}}/issues/{{.args.issue_number}}"
method: PATCH
body: |
{
"title": "{{.args.title}}",
"body": "{{.args.body}}",
"state": "{{.args.state}}",
"labels": {{.args.labels | toJson}},
"assignees": {{.args.assignees | toJson}},
"milestone": {{.args.milestone}}
}
headers:
- key: Authorization
value: "Bearer {{.config.accessToken}}"
- key: Accept
value: "application/vnd.github+json"
- key: X-GitHub-Api-Version
value: "2022-11-28"
- name: add_issue_comment
description: 在GitHub Issue中添加评论
args:
- name: owner
type: string
required: true
description: "Repository owner (username or organization)"
- name: repo
type: string
required: true
description: "Repository name"
- name: issue_number
type: number
required: true
description: "Issue number to comment on"
- name: body
type: string
required: true
description: "Comment text"
requestTemplate:
url: "https://api.github.com/repos/{{.args.owner}}/{{.args.repo}}/issues/{{.args.issue_number}}/comments"
method: POST
body: |
{
"body": "{{.args.body}}"
}
headers:
- key: Authorization
value: "Bearer {{.config.accessToken}}"
- key: Accept
value: "application/vnd.github+json"
- key: X-GitHub-Api-Version
value: "2022-11-28"
- name: search_code
description: 在GitHub仓库中搜索代码
args:
- name: q
type: string
required: true
description: "Search query using GitHub code search syntax"
- name: sort
type: string
required: false
description: "Sort field ('indexed' only)"
- name: order
type: string
required: false
description: "Sort order ('asc' or 'desc')"
- name: per_page
type: number
required: false
description: "Results per page (max 100)"
- name: page
type: number
required: false
description: "Page number"
requestTemplate:
url: "https://api.github.com/search/code?q={{.args.q}}&sort={{.args.sort}}&order={{.args.order}}&per_page={{.args.per_page}}&page={{.args.page}}"
method: GET
headers:
- key: Authorization
value: "Bearer {{.config.accessToken}}"
- key: Accept
value: "application/vnd.github+json"
- key: X-GitHub-Api-Version
value: "2022-11-28"
- name: search_issues
description: 在GitHub仓库中搜索Issues和Pull Requests
args:
- name: q
type: string
required: true
description: "Search query using GitHub issues search syntax"
- name: sort
type: string
required: false
description: "Sort field (comments, reactions, created, etc.)"
- name: order
type: string
required: false
description: "Sort order ('asc' or 'desc')"
- name: per_page
type: number
required: false
description: "Results per page (max 100)"
- name: page
type: number
required: false
description: "Page number"
requestTemplate:
url: "https://api.github.com/search/issues?q={{.args.q}}&sort={{.args.sort}}&order={{.args.order}}&per_page={{.args.per_page}}&page={{.args.page}}"
method: GET
headers:
- key: Authorization
value: "Bearer {{.config.accessToken}}"
- key: Accept
value: "application/vnd.github+json"
- key: X-GitHub-Api-Version
value: "2022-11-28"
- name: search_users
description: 在GitHub中搜索用户
args:
- name: q
type: string
required: true
description: "Search query using GitHub users search syntax"
- name: sort
type: string
required: false
description: "Sort field (followers, repositories, joined)"
- name: order
type: string
required: false
description: "Sort order ('asc' or 'desc')"
- name: per_page
type: number
required: false
description: "Results per page (max 100)"
- name: page
type: number
required: false
description: "Page number"
requestTemplate:
url: "https://api.github.com/search/users?q={{.args.q}}&sort={{.args.sort}}&order={{.args.order}}&per_page={{.args.per_page}}&page={{.args.page}}"
method: GET
headers:
- key: Authorization
value: "Bearer {{.config.accessToken}}"
- key: Accept
value: "application/vnd.github+json"
- key: X-GitHub-Api-Version
value: "2022-11-28"
- name: get_issue
description: 获取GitHub仓库中特定Issue的详细信息
args:
- name: owner
type: string
required: true
description: "Repository owner (username or organization)"
- name: repo
type: string
required: true
description: "Repository name"
- name: issue_number
type: number
required: true
description: "Issue number to retrieve"
requestTemplate:
url: "https://api.github.com/repos/{{.args.owner}}/{{.args.repo}}/issues/{{.args.issue_number}}"
method: GET
headers:
- key: Authorization
value: "Bearer {{.config.accessToken}}"
- key: Accept
value: "application/vnd.github+json"
- key: X-GitHub-Api-Version
value: "2022-11-28"
- name: get_pull_request
description: 获取GitHub仓库中特定Pull Request的详细信息
args:
- name: owner
type: string
required: true
description: "Repository owner (username or organization)"
- name: repo
type: string
required: true
description: "Repository name"
- name: pull_number
type: number
required: true
description: "Pull request number"
requestTemplate:
url: "https://api.github.com/repos/{{.args.owner}}/{{.args.repo}}/pulls/{{.args.pull_number}}"
method: GET
headers:
- key: Authorization
value: "Bearer {{.config.accessToken}}"
- key: Accept
value: "application/vnd.github+json"
- key: X-GitHub-Api-Version
value: "2022-11-28"
- name: list_pull_requests
description: 列出并过滤GitHub仓库的Pull Requests
args:
- name: owner
type: string
required: true
description: "Repository owner (username or organization)"
- name: repo
type: string
required: true
description: "Repository name"
- name: state
type: string
required: false
description: "State of the pull requests to return"
- name: head
type: string
required: false
description: "Filter by head user or head organization and branch name"
- name: base
type: string
required: false
description: "Filter by base branch name"
- name: sort
type: string
required: false
description: "What to sort results by"
- name: direction
type: string
required: false
description: "The direction of the sort"
- name: per_page
type: number
required: false
description: "Results per page (max 100)"
- name: page
type: number
required: false
description: "Page number of the results"
requestTemplate:
url: "https://api.github.com/repos/{{.args.owner}}/{{.args.repo}}/pulls?state={{.args.state}}&head={{.args.head}}&base={{.args.base}}&sort={{.args.sort}}&direction={{.args.direction}}&per_page={{.args.per_page}}&page={{.args.page}}"
method: GET
headers:
- key: Authorization
value: "Bearer {{.config.accessToken}}"
- key: Accept
value: "application/vnd.github+json"
- key: X-GitHub-Api-Version
value: "2022-11-28"
- name: create_pull_request_review
description: 在GitHub Pull Request上创建review
args:
- name: owner
type: string
required: true
description: "Repository owner (username or organization)"
- name: repo
type: string
required: true
description: "Repository name"
- name: pull_number
type: number
required: true
description: "Pull request number"
- name: commit_id
type: string
required: false
description: "The SHA of the commit that needs a review"
- name: body
type: string
required: true
description: "The body text of the review"
- name: event
type: string
required: true
description: "The review action to perform"
- name: comments
type: array
items:
type: object
properties:
path:
type: string
description: "The relative path to the file being commented on"
position:
type: number
description: "The position in the diff where you want to add a review comment"
body:
type: string
description: "Text of the review comment"
required: false
description: "Comments to post as part of the review (specify either position or line, not both)"
requestTemplate:
url: "https://api.github.com/repos/{{.args.owner}}/{{.args.repo}}/pulls/{{.args.pull_number}}/reviews"
method: POST
body: |
{
"body": "{{.args.body}}",
"event": "{{.args.event}}",
"commit_id": "{{.args.commit_id}}",
"comments": {{.args.comments | toJson}}
}
headers:
- key: Authorization
value: "Bearer {{.config.accessToken}}"
- key: Accept
value: "application/vnd.github+json"
- key: X-GitHub-Api-Version
value: "2022-11-28"
- name: merge_pull_request
description: 合并GitHub Pull Request
args:
- name: owner
type: string
required: true
description: "Repository owner (username or organization)"
- name: repo
type: string
required: true
description: "Repository name"
- name: pull_number
type: number
required: true
description: "Pull request number"
- name: commit_title
type: string
required: false
description: "Title for the automatic commit message"
- name: commit_message
type: string
required: false
description: "Extra detail to append to automatic commit message"
- name: merge_method
type: string
required: false
description: "Merge method to use"
requestTemplate:
url: "https://api.github.com/repos/{{.args.owner}}/{{.args.repo}}/pulls/{{.args.pull_number}}/merge"
method: PUT
body: |
{
"commit_title": "{{.args.commit_title}}",
"commit_message": "{{.args.commit_message}}",
"merge_method": "{{.args.merge_method}}"
}
headers:
- key: Authorization
value: "Bearer {{.config.accessToken}}"
- key: Accept
value: "application/vnd.github+json"
- key: X-GitHub-Api-Version
value: "2022-11-28"
- name: get_pull_request_files
description: 获取GitHub Pull Request中更改的文件列表
args:
- name: owner
type: string
required: true
description: "Repository owner (username or organization)"
- name: repo
type: string
required: true
description: "Repository name"
- name: pull_number
type: number
required: true
description: "Pull request number"
requestTemplate:
url: "https://api.github.com/repos/{{.args.owner}}/{{.args.repo}}/pulls/{{.args.pull_number}}/files"
method: GET
headers:
- key: Authorization
value: "Bearer {{.config.accessToken}}"
- key: Accept
value: "application/vnd.github+json"
- key: X-GitHub-Api-Version
value: "2022-11-28"
- name: get_pull_request_status
description: 获取GitHub Pull Request的状态检查结果
args:
- name: owner
type: string
required: true
description: "Repository owner (username or organization)"
- name: repo
type: string
required: true
description: "Repository name"
- name: pull_number
type: number
required: true
description: "Pull request number"
requestTemplate:
url: "https://api.github.com/repos/{{.args.owner}}/{{.args.repo}}/pulls/{{.args.pull_number}}/status"
method: GET
headers:
- key: Authorization
value: "Bearer {{.config.accessToken}}"
- key: Accept
value: "application/vnd.github+json"
- key: X-GitHub-Api-Version
value: "2022-11-28"
- name: update_pull_request_branch
description: 使用base分支的最新更改更新Pull Request分支
args:
- name: owner
type: string
required: true
description: "Repository owner (username or organization)"
- name: repo
type: string
required: true
description: "Repository name"
- name: pull_number
type: number
required: true
description: "Pull request number"
- name: expected_head_sha
type: string
required: false
description: "The expected SHA of the pull request's HEAD ref"
requestTemplate:
url: "https://api.github.com/repos/{{.args.owner}}/{{.args.repo}}/pulls/{{.args.pull_number}}/update-branch"
method: PUT
body: |
{
"expected_head_sha": "{{.args.expected_head_sha}}"
}
headers:
- key: Authorization
value: "Bearer {{.config.accessToken}}"
- key: Accept
value: "application/vnd.github+json"
- key: X-GitHub-Api-Version
value: "2022-11-28"
- name: get_pull_request_comments
description: 获取GitHub Pull Request的review评论
args:
- name: owner
type: string
required: true
description: "Repository owner (username or organization)"
- name: repo
type: string
required: true
description: "Repository name"
- name: pull_number
type: number
required: true
description: "Pull request number"
requestTemplate:
url: "https://api.github.com/repos/{{.args.owner}}/{{.args.repo}}/pulls/{{.args.pull_number}}/comments"
method: GET
headers:
- key: Authorization
value: "Bearer {{.config.accessToken}}"
- key: Accept
value: "application/vnd.github+json"
- key: X-GitHub-Api-Version
value: "2022-11-28"
- name: get_pull_request_reviews
description: 获取GitHub Pull Request的reviews
args:
- name: owner
type: string
required: true
description: "Repository owner (username or organization)"
- name: repo
type: string
required: true
description: "Repository name"
- name: pull_number
type: number
required: true
description: "Pull request number"
requestTemplate:
url: "https://api.github.com/repos/{{.args.owner}}/{{.args.repo}}/pulls/{{.args.pull_number}}/reviews"
method: GET
headers:
- key: Authorization
value: "Bearer {{.config.accessToken}}"
- key: Accept
value: "application/vnd.github+json"
- key: X-GitHub-Api-Version
value: "2022-11-28"

38
plugins/wasm-go/mcp-servers/mcp-notion/README.md Normal file
View File

@@ -0,0 +1,38 @@
# Notion MCP Server
A Notion workspace is a collaborative environment where teams can organize work, manage projects, and store information in a highly customizable way. Notion's REST API facilitates direct interactions with workspace elements through programming.
Source code: [https://github.com/makenotion/notion-mcp-server/tree/main](https://github.com/makenotion/notion-mcp-server/tree/main)
## Feature
Notion MCP Server provides the following features:
- **Pages**: Create, update, and retrieve page content.
- **Databases**: Manage database, properties, entries, and schemas.
- **Users**: Access user profiles and permissions.
- **Comments**: Handle page and inline comments.
- **Content Queries**: Search through workspace content.
## Usage Guide
### Get Notion Integration token
Go to [https://www.notion.so/profile/integrations](https://www.notion.so/profile/integrations) and create a new internal integration or select an existing one.
### Generate SSE URL
On the MCP Server interface, log in and enter the token to generate the URL.
### Configure MCP Client
On the user's MCP Client interface, add the generated SSE URL to the MCP Server list.
```json
"mcpServers": {
"notion": {
"url": "http://mcp.higress.ai/mcp-notion/{generate_key}",
}
}
```

38
plugins/wasm-go/mcp-servers/mcp-notion/README_ZH.md Normal file
View File

@@ -0,0 +1,38 @@
# Notion MCP Server
Notion 工作区是一个协作环境，团队可以在其中以高度可定制的方式组织工作、管理项目和存储信息。Notion 的 REST API 方便通过编程与工作区元素直接交互。
源码地址：[https://github.com/makenotion/notion-mcp-server/tree/main](https://github.com/makenotion/notion-mcp-server/tree/main)
## 功能
Notion MCP Server 提供了以下功能：
- **页面**：创建、更新和检索页面内容。
- **数据库**：管理数据库、属性、条目和模式。
- **用户**：访问用户配置文件和权限。
- **评论**：处理页面和内联评论。
- **内容查询**：搜索工作区内容。
## 使用教程
### 获取 Notion 集成 Key
在Notion中设置集成，转到 [https://www.notion.so/profile/integrations](https://www.notion.so/profile/integrations) 并创建一个新的内部集成或选择一个现有的集成。
### 生成 SSE URL
在 MCP Server 界面，登录后输入 AccessToken，生成URL。
### 配置 MCP Client
在用户的 MCP Client 界面，将生成的 SSE URL添加到 MCP Server列表中。
```json
"mcpServers": {
"notion": {
"url": "http://mcp.higress.ai/mcp-notion/{generate_key}",
}
}
```

434
plugins/wasm-go/mcp-servers/mcp-notion/mcp-server.yaml Normal file
View File

@@ -0,0 +1,434 @@
server:
name: notion-api-server
config:
token: ""
tools:
- name: getUser
description: "获取指定用户信息"
args:
- name: user_id
description: "用户UUID"
type: string
required: true
requestTemplate:
url: "https://api.notion.com/v1/users/{{.args.user_id}}"
method: GET
headers:
- key: Authorization
value: "Bearer {{.config.token}}"
- key: Notion-Version
value: 2022-06-28
responseTemplate:
body: |
### 用户信息
- **ID**: {{.id}}
- **类型**: {{.type}}
- **名称**: {{.name}}
{{- if eq .type "person"}}
- **邮箱**: {{.person.email}}
{{- end}}
- **头像**: [链接]({{.avatar_url}})
- name: listUsers
description: "分页列出所有用户"
args:
- name: start_cursor
description: "分页起始游标"
type: string
required: false
- name: page_size
description: "每页数量(默认100)"
type: integer
required: false
default: 100
requestTemplate:
url: "https://api.notion.com/v1/users"
method: GET
argsToUrlParam: true
headers:
- key: Authorization
value: "Bearer {{.config.token}}"
- key: Notion-Version
value: 2022-06-28
responseTemplate:
body: |
用户列表(共{{len .results}}项)
{{- range .results}}
### {{.name}}
- 类型: {{.type}}
- 最后编辑时间: {{.last_edited_time}}
{{- end}}
- name: getCurrentUser
description: "获取当前认证用户信息"
requestTemplate:
url: "https://api.notion.com/v1/users/me"
method: GET
headers:
- key: Authorization
value: "Bearer {{.config.token}}"
- key: Notion-Version
value: 2022-06-28
responseTemplate:
body: |
## 当前用户
- **身份类型**: {{.type}}
{{- if .bot}}
- **所属者**: {{.bot.owner.user.name}} ({{.bot.owner.user.person.email}})
{{- end}}
- name: queryDatabase
description: "查询数据库"
args:
- name: database_id
type: string
required: true
- name: filter_properties
type: array
items:
type: string
requestTemplate:
url: "https://api.notion.com/v1/databases/{{.args.database_id}}/query"
method: POST
body: |
{
"filter": {{toJson .args.filter}},
"sorts": {{toJson .args.sorts}}
}
headers:
- key: Authorization
value: "Bearer {{.config.token}}"
- key: Notion-Version
value: 2022-06-28
responseTemplate:
body: |
## 查询结果
{{- range .results}}
### {{.properties.Name.title.plain_text}}
- 创建时间: {{.created_time}}
- 最后编辑时间: {{.last_edited_time}}
{{- end}}
- name: search
description: "搜索页面和数据库"
args:
- name: query
type: string
required: false
- name: sort
type: object
properties:
direction:
type: string
timestamp:
type: string
requestTemplate:
url: "https://api.notion.com/v1/search"
method: POST
body: |
{
"query": "{{.args.query}}",
"sort": {{toJson .args.sort}}
}
headers:
- key: Authorization
value: "Bearer {{.config.token}}"
- key: Notion-Version
value: 2022-06-28
responseTemplate:
body: |
## 搜索结果
{{- range .results}}
### {{.title.plain_text}}
- 类型: {{.object}}
- 最后编辑时间: {{.last_edited_time}}
{{- end}}
- name: getBlock
description: "获取指定块信息"
args:
- name: block_id
type: string
required: true
requestTemplate:
url: "https://api.notion.com/v1/blocks/{{.args.block_id}}"
method: GET
headers:
- key: Authorization
value: "Bearer {{.config.token}}"
- key: Notion-Version
value: 2022-06-28
responseTemplate:
body: |
## 块信息
- 类型: {{.type}}
- 创建时间: {{.created_time}}
- 最后编辑时间: {{.last_edited_time}}
- name: updateBlock
description: "更新块内容"
args:
- name: block_id
type: string
required: true
- name: type
type: object
properties: {}
- name: archived
type: boolean
default: true
requestTemplate:
url: "https://api.notion.com/v1/blocks/{{.args.block_id}}"
method: PATCH
body: |
{
"type": {{toJson .args.type}},
"archived": {{.args.archived}}
}
headers:
- key: Authorization
value: "Bearer {{.config.token}}"
- key: Notion-Version
value: 2022-06-28
responseTemplate:
body: |
## 更新结果
- 状态: 成功
- 块ID: {{.id}}
- name: deleteBlock
description: "删除指定块"
args:
- name: block_id
type: string
required: true
requestTemplate:
url: "https://api.notion.com/v1/blocks/{{.args.block_id}}"
method: DELETE
headers:
- key: Authorization
value: "Bearer {{.config.token}}"
- key: Notion-Version
value: 2022-06-28
responseTemplate:
body: |
## 删除结果
- 状态: 成功
- 块ID: {{.args.block_id}}
- name: getPage
description: "获取指定页面信息"
args:
- name: page_id
type: string
required: true
- name: filter_properties
type: string
required: false
requestTemplate:
url: "https://api.notion.com/v1/pages/{{.args.page_id}}"
method: GET
argsToUrlParam: true
headers:
- key: Authorization
value: "Bearer {{.config.token}}"
- key: Notion-Version
value: 2022-06-28
responseTemplate:
body: |
## 页面信息
- 标题: {{.properties.title.title.plain_text}}
- 创建时间: {{.created_time}}
- 最后编辑时间: {{.last_edited_time}}
- name: updatePage
description: "更新页面属性"
args:
- name: page_id
type: string
required: true
- name: properties
type: object
properties: {}
- name: in_trash
type: boolean
default: false
requestTemplate:
url: "https://api.notion.com/v1/pages/{{.args.page_id}}"
method: PATCH
body: |
{
"properties": {{toJson .args.properties}},
"in_trash": {{.args.in_trash}}
}
headers:
- key: Authorization
value: "Bearer {{.config.token}}"
- key: Notion-Version
value: 2022-06-28
responseTemplate:
body: |
## 更新结果
- 状态: 成功
- 页面ID: {{.id}}
- name: createDatabase
description: "创建新数据库"
args:
- name: parent
type: object
properties:
page_id:
type: string
required: true
- name: properties
type: object
properties: {}
required: true
requestTemplate:
url: "https://api.notion.com/v1/databases"
method: POST
body: |
{
"parent": {{toJson .args.parent}},
"properties": {{toJson .args.properties}}
}
headers:
- key: Authorization
value: "Bearer {{.config.token}}"
- key: Notion-Version
value: 2022-06-28
responseTemplate:
body: |
## 创建结果
- 数据库ID: {{.id}}
- 标题: {{.title.plain_text}}
- 创建时间: {{.created_time}}
- name: updateDatabase
description: "更新数据库"
args:
- name: database_id
type: string
required: true
- name: title
type: array
items:
type: object
properties:
text:
type: object
properties:
content:
type: string
requestTemplate:
url: "https://api.notion.com/v1/databases/{{.args.database_id}}"
method: PATCH
body: |
{
"title": {{toJson .args.title}}
}
headers:
- key: Authorization
value: "Bearer {{.config.token}}"
- key: Notion-Version
value: 2022-06-28
responseTemplate:
body: |
## 更新结果
- 数据库ID: {{.id}}
- 新标题: {{.title.plain_text}}
- name: getDatabase
description: "获取数据库信息"
args:
- name: database_id
type: string
required: true
requestTemplate:
url: "https://api.notion.com/v1/databases/{{.args.database_id}}"
method: GET
headers:
- key: Authorization
value: "Bearer {{.config.token}}"
- key: Notion-Version
value: 2022-06-28
responseTemplate:
body: |
## 数据库信息
- 标题: {{.title.plain_text}}
- 创建时间: {{.created_time}}
- 最后编辑时间: {{.last_edited_time}}
- 属性数量: {{len .properties}}
- name: getPageProperty
description: "获取页面属性项"
args:
- name: page_id
type: string
required: true
- name: property_id
type: string
required: true
- name: page_size
type: integer
required: false
- name: start_cursor
type: string
required: false
requestTemplate:
url: "https://api.notion.com/v1/pages/{{.args.page_id}}/properties/{{.args.property_id}}"
method: GET
argsToUrlParam: true
headers:
- key: Authorization
value: "Bearer {{.config.token}}"
- key: Notion-Version
value: 2022-06-28
responseTemplate:
body: |
## 属性项
{{- range .results}}
- 类型: {{.type}}
- 值: {{.value}}
{{- end}}
- name: createComment
description: "创建评论"
args:
- name: parent
type: object
properties:
page_id:
type: string
required: true
- name: rich_text
type: array
items:
type: object
properties:
text:
type: object
properties:
content:
type: string
required: true
requestTemplate:
url: "https://api.notion.com/v1/comments"
method: POST
body: |
{
"parent": {{toJson .args.parent}},
"rich_text": {{toJson .args.rich_text}}
}
headers:
- key: Authorization
value: "Bearer {{.config.token}}"
- key: Notion-Version
value: 2022-06-28
responseTemplate:
body: |
## 评论创建结果
- 评论ID: {{.id}}
- 创建时间: {{.created_time}}
- 内容: {{.rich_text.text.content}}

23
plugins/wasm-go/mcp-servers/mcp-openweather/README.md Normal file
View File

@@ -0,0 +1,23 @@
# Weather MCP Server
A weather query MCP service based on OpenWeather API, retrieving weather information for specified cities.
Source code: [https://github.com/MrCare/mcp_tool](https://github.com/MrCare/mcp_tool)
## Usage Guide
### Generate SSE URL
On the MCP Server interface, log in to generate the URL.
### Configure MCP Client
On the user's MCP Client interface, add the generated SSE URL to the MCP Server list.
```json
"mcpServers": {
"weather": {
"url": "http://mcp.higress.ai/mcp-weather/{generate_key}",
}
}
```

24
plugins/wasm-go/mcp-servers/mcp-openweather/README_ZH.md Normal file
View File

@@ -0,0 +1,24 @@
# Weather MCP Server
基于 OpenWeather API 的天气查询 MCP 服务，获取指定城市的天气信息。
源码地址：[https://github.com/MrCare/mcp_tool](https://github.com/MrCare/mcp_tool)
## 使用教程
### 生成 SSE URL
在 MCP Server 界面，登录后生成URL。
### 配置 MCP Client
在用户的 MCP Client 界面，将生成的 SSE URL添加到 MCP Server列表中。
```json
"mcpServers": {
"weather": {
"url": "http://mcp.higress.ai/mcp-weather/{generate_key}",
}
}
```

85
plugins/wasm-go/mcp-servers/mcp-openweather/mcp-server.yaml Normal file
View File

@@ -0,0 +1,85 @@
server:
name: weather-server
config:
apiKey: ""
tools:
- name: get_weather
description: "获取指定城市的实时天气信息"
args:
- name: city
description: "城市名称（支持中文或英文，如：苏州、suzhou）"
type: string
required: true
- name: units
description: "温度单位 (metric: 摄氏度, imperial: 华氏度)"
type: string
required: false
default: "metric"
- name: lang
description: "返回语言 (zh_cn: 中文, en: 英文)"
type: string
required: false
default: "zh_cn"
requestTemplate:
url: "http://api.openweathermap.org/data/2.5/weather"
method: GET
argsToUrlParam: true
headers:
- key: x-api-key
value: "{{.config.apiKey}}"
responseTemplate:
body: |
{
"description": "{{ (index .weather 0).description}}",
"temperature": {{.main.temp}},
"humidity": {{.main.humidity}},
"wind_speed": {{.wind.speed}},
"city": "{{.args.city}}"
}
- name: get_weather_forecast
description: "获取指定城市的天气预报信息"
args:
- name: city
description: "城市名称（支持中文或英文，如：苏州、suzhou）"
type: string
required: true
- name: days
description: "预报天数（最多5天）"
type: integer
required: false
default: 5
- name: units
description: "温度单位 (metric: 摄氏度, imperial: 华氏度)"
type: string
required: false
default: "metric"
- name: lang
description: "返回语言 (zh_cn: 中文, en: 英文)"
type: string
required: false
default: "zh_cn"
requestTemplate:
url: "http://api.openweathermap.org/data/2.5/forecast"
method: GET
argsToUrlParam: true
headers:
- key: x-api-key
value: "{{.config.apiKey}}"
responseTemplate:
body: |
{
"forecasts":
{{- range $index, $item := .list }}
{
"date": "{{$item.dt_txt}}",
"description": "{{ (index $item.weather0).description}}",
"temp_min": {{$item.main.temp_min}},
"temp_max": {{$item.main.temp_max}},
"humidity": {{$item.main.humidity}},
"wind_speed": {{$item.wind.speed}},
"city": "{{$.args.city}}"
}{{if not $index.last}},{{end}}
{{- end }}
}