init alapi.cn mcp

Author: anhao

.cursor/rules/mcp.mdc

@@ -0,0 +1,4 @@
+.idea
+*.exe
+build
+.vs_code

.gitignore

@@ -0,0 +1,85 @@
+# ALAPI MCP Server
+
+这是一个基于 [ALAPI](https://www.alapi.cn) 的 MCP (Model Control Protocol) 服务器实现，可以自动将 ALAPI 的 OpenAPI 规范转换为 MCP 工具。
+
+## 功能特点
+
+- 自动加载 ALAPI OpenAPI 规范
+- 支持加载全部或指定 API (短视频解析、天气查询、每天60秒读懂世界、企业查询...)
+- 符合 MCP 协议标准
+- 统一的错误处理和响应格式
+- 支持环境变量配置
+
+## 环境要求
+
+- Go 1.24.1 或更高版本
+- 有效的 ALAPI Token
+- 支持 MCP 的客户端（如 Claude Desktop、Continue、Cursor 等）
+
+## 安装
+
+### 构建安装
+```bash
+#Github
+git clone https://github.com/alapi-sdk/mcp-alapi-cn.git
+
+#CNB 国内加速地址
+#git clone https://cnb.cool/alapi/mcp-alapi-cn.git
+
+cd mcp-server
+go mod tidy
+go build
+```
+
+### 下载已构建的软件包
+
+Github:
+
+CNB(国内加速): 
+
+
+
+## 配置和使用
+
+### 环境变量配置
+
+项目使用以下环境变量：
+
+- `ALAPI_TOKEN`（必需）：ALAPI 的认证令牌,在 [token管理](https://www.alapi.cn/dashboard/data/token) 里面创建, **如果不设置，mcp 会启动不了**
+- `ALAPI_ID`（可选）：指定要加载的 API ID，不设置则加载所有 API（实际的API_id 可通过 [ALAPI](https://www.alapi.cn)  官网查看，可在我的API里面查询）
+
+
+
+
+### Cursor配置方式
+
+1. 打开Cursor设置 > 扩展 > MCP工具
+2. 添加新的MCP工具
+3. 按照以下格式填写配置：
+
+```json
+{
+    "mcpServers": {
+        "mcp-alapi-cn": {
+            "command": "C:\\Users\\Administrator\\实际目录\\mcp-alapi-cn.exe",
+            "env": {
+                "ALAPI_TOKEN": "xxxx",
+                "ALAPI_API_ID": "0"
+            }
+        }
+    }
+}
+```
+
+### CherryStudio配置方式
+1. 打开 CherryStudio 设置 -> MCP 服务器 
+2. 添加MCP服务器
+3. 配置说明：
+
+名称： `MCP-ALAPI-CN`  
+类型： `STDIO`    
+命令： `C:\\Users\\Administrator\\实际目录\\mcp-alapi-cn.exe`
+环境变量：
+```
+ALAPI_TOKEN=你的token
+```

README.md

@@ -0,0 +1,47 @@
+@echo off
+setlocal
+
+set VERSION=1.0.0
+set BUILD_DIR=build
+
+:: 创建构建目录
+if not exist %BUILD_DIR% mkdir %BUILD_DIR%
+
+:: 清理旧的构建文件
+echo Cleaning build directory...
+del /Q %BUILD_DIR%\*
+
+:: Windows 构建
+echo Building for Windows/amd64...
+set GOOS=windows
+set GOARCH=amd64
+go build -o "%BUILD_DIR%\mcp-alapi-cn-%VERSION%-windows-amd64.exe" -ldflags="-s -w" main.go
+
+echo Building for Windows/arm64...
+set GOOS=windows
+set GOARCH=arm64
+go build -o "%BUILD_DIR%\mcp-alapi-cn-%VERSION%-windows-arm64.exe" -ldflags="-s -w" main.go
+
+:: Linux 构建
+echo Building for Linux/amd64...
+set GOOS=linux
+set GOARCH=amd64
+go build -o "%BUILD_DIR%\mcp-alapi-cn-%VERSION%-linux-amd64" -ldflags="-s -w" main.go
+
+echo Building for Linux/arm64...
+set GOOS=linux
+set GOARCH=arm64
+go build -o "%BUILD_DIR%\mcp-alapi-cn-%VERSION%-linux-arm64" -ldflags="-s -w" main.go
+
+:: macOS 构建
+echo Building for macOS/amd64...
+set GOOS=darwin
+set GOARCH=amd64
+go build -o "%BUILD_DIR%\mcp-alapi-cn-%VERSION%-darwin-amd64" -ldflags="-s -w" main.go
+
+echo Building for macOS/arm64...
+set GOOS=darwin
+set GOARCH=arm64
+go build -o "%BUILD_DIR%\mcp-alapi-cn-%VERSION%-darwin-arm64" -ldflags="-s -w" main.go
+
+echo Build complete! Output files are in the build directory.

build.bat

@@ -0,0 +1,48 @@
+#!/bin/bash
+
+# 版本号
+VERSION="1.0.0"
+
+# 创建构建目录
+mkdir -p build
+
+# 构建函数
+build() {
+    local GOOS=$1
+    local GOARCH=$2
+    local SUFFIX=$3
+    
+    echo "Building for $GOOS/$GOARCH..."
+    
+    # 设置输出文件名
+    local OUTPUT="build/mcp-alapi-cn-${VERSION}-${GOOS}-${GOARCH}${SUFFIX}"
+    
+    # 执行构建
+    GOOS=$GOOS GOARCH=$GOARCH go build -o "$OUTPUT" -ldflags="-s -w" main.go
+    
+    # 检查构建结果
+    if [ $? -eq 0 ]; then
+        echo "✓ Successfully built $OUTPUT"
+    else
+        echo "✗ Failed to build for $GOOS/$GOARCH"
+        exit 1
+    fi
+}
+
+# 清理旧的构建文件
+echo "Cleaning build directory..."
+rm -rf build/*
+
+# Windows 构建
+build "windows" "amd64" ".exe"
+build "windows" "arm64" ".exe"
+
+# Linux 构建
+build "linux" "amd64" ""
+build "linux" "arm64" ""
+
+# macOS 构建
+build "darwin" "amd64" ""
+build "darwin" "arm64" ""
+
+echo "Build complete! Output files are in the build directory."

build.sh

@@ -0,0 +1,24 @@
+module mcp-alapi-cn
+
+go 1.24.1
+
+require (
+	github.com/getkin/kin-openapi v0.131.0
+	github.com/go-resty/resty/v2 v2.16.5
+	github.com/mark3labs/mcp-go v0.17.0
+)
+
+require (
+	github.com/go-openapi/jsonpointer v0.21.0 // indirect
+	github.com/go-openapi/swag v0.23.0 // indirect
+	github.com/google/uuid v1.6.0 // indirect
+	github.com/josharian/intern v1.0.0 // indirect
+	github.com/mailru/easyjson v0.7.7 // indirect
+	github.com/mohae/deepcopy v0.0.0-20170929034955-c48cc78d4826 // indirect
+	github.com/oasdiff/yaml v0.0.0-20250309154309-f31be36b4037 // indirect
+	github.com/oasdiff/yaml3 v0.0.0-20250309153720-d2182401db90 // indirect
+	github.com/perimeterx/marshmallow v1.1.5 // indirect
+	github.com/yosida95/uritemplate/v3 v3.0.2 // indirect
+	golang.org/x/net v0.33.0 // indirect
+	gopkg.in/yaml.v3 v3.0.1 // indirect
+)

go.mod

@@ -0,0 +1,51 @@
+github.com/davecgh/go-spew v1.1.1 h1:vj9j/u1bqnvCEfJOwUhtlOARqs3+rkHYY13jYWTU97c=
+github.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=
+github.com/getkin/kin-openapi v0.131.0 h1:NO2UeHnFKRYhZ8wg6Nyh5Cq7dHk4suQQr72a4pMrDxE=
+github.com/getkin/kin-openapi v0.131.0/go.mod h1:3OlG51PCYNsPByuiMB0t4fjnNlIDnaEDsjiKUV8nL58=
+github.com/go-openapi/jsonpointer v0.21.0 h1:YgdVicSA9vH5RiHs9TZW5oyafXZFc6+2Vc1rr/O9oNQ=
+github.com/go-openapi/jsonpointer v0.21.0/go.mod h1:IUyH9l/+uyhIYQ/PXVA41Rexl+kOkAPDdXEYns6fzUY=
+github.com/go-openapi/swag v0.23.0 h1:vsEVJDUo2hPJ2tu0/Xc+4noaxyEffXNIs3cOULZ+GrE=
+github.com/go-openapi/swag v0.23.0/go.mod h1:esZ8ITTYEsH1V2trKHjAN8Ai7xHb8RV+YSZ577vPjgQ=
+github.com/go-resty/resty/v2 v2.16.5 h1:hBKqmWrr7uRc3euHVqmh1HTHcKn99Smr7o5spptdhTM=
+github.com/go-resty/resty/v2 v2.16.5/go.mod h1:hkJtXbA2iKHzJheXYvQ8snQES5ZLGKMwQ07xAwp/fiA=
+github.com/go-test/deep v1.0.8 h1:TDsG77qcSprGbC6vTN8OuXp5g+J+b5Pcguhf7Zt61VM=
+github.com/go-test/deep v1.0.8/go.mod h1:5C2ZWiW0ErCdrYzpqxLbTX7MG14M9iiw8DgHncVwcsE=
+github.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=
+github.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=
+github.com/josharian/intern v1.0.0 h1:vlS4z54oSdjm0bgjRigI+G1HpF+tI+9rE5LLzOg8HmY=
+github.com/josharian/intern v1.0.0/go.mod h1:5DoeVV0s6jJacbCEi61lwdGj/aVlrQvzHFFd8Hwg//Y=
+github.com/kr/pretty v0.3.1 h1:flRD4NNwYAUpkphVc1HcthR4KEIFJ65n8Mw5qdRn3LE=
+github.com/kr/pretty v0.3.1/go.mod h1:hoEshYVHaxMs3cyo3Yncou5ZscifuDolrwPKZanG3xk=
+github.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY=
+github.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE=
+github.com/mailru/easyjson v0.7.7 h1:UGYAvKxe3sBsEDzO8ZeWOSlIQfWFlxbzLZe7hwFURr0=
+github.com/mailru/easyjson v0.7.7/go.mod h1:xzfreul335JAWq5oZzymOObrkdz5UnU4kGfJJLY9Nlc=
+github.com/mark3labs/mcp-go v0.17.0 h1:5Ps6T7qXr7De/2QTqs9h6BKeZ/qdeUeGrgM5lPzi930=
+github.com/mark3labs/mcp-go v0.17.0/go.mod h1:KmJndYv7GIgcPVwEKJjNcbhVQ+hJGJhrCCB/9xITzpE=
+github.com/mohae/deepcopy v0.0.0-20170929034955-c48cc78d4826 h1:RWengNIwukTxcDr9M+97sNutRR1RKhG96O6jWumTTnw=
+github.com/mohae/deepcopy v0.0.0-20170929034955-c48cc78d4826/go.mod h1:TaXosZuwdSHYgviHp1DAtfrULt5eUgsSMsZf+YrPgl8=
+github.com/oasdiff/yaml v0.0.0-20250309154309-f31be36b4037 h1:G7ERwszslrBzRxj//JalHPu/3yz+De2J+4aLtSRlHiY=
+github.com/oasdiff/yaml v0.0.0-20250309154309-f31be36b4037/go.mod h1:2bpvgLBZEtENV5scfDFEtB/5+1M4hkQhDQrccEJ/qGw=
+github.com/oasdiff/yaml3 v0.0.0-20250309153720-d2182401db90 h1:bQx3WeLcUWy+RletIKwUIt4x3t8n2SxavmoclizMb8c=
+github.com/oasdiff/yaml3 v0.0.0-20250309153720-d2182401db90/go.mod h1:y5+oSEHCPT/DGrS++Wc/479ERge0zTFxaF8PbGKcg2o=
+github.com/perimeterx/marshmallow v1.1.5 h1:a2LALqQ1BlHM8PZblsDdidgv1mWi1DgC2UmX50IvK2s=
+github.com/perimeterx/marshmallow v1.1.5/go.mod h1:dsXbUu8CRzfYP5a87xpp0xq9S3u0Vchtcl8we9tYaXw=
+github.com/pmezard/go-difflib v1.0.0 h1:4DBwDE0NGyQoBHbLQYPwSUPoCMWR5BEzIk/f1lZbAQM=
+github.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=
+github.com/rogpeppe/go-internal v1.12.0 h1:exVL4IDcn6na9z1rAb56Vxr+CgyK3nn3O+epU5NdKM8=
+github.com/rogpeppe/go-internal v1.12.0/go.mod h1:E+RYuTGaKKdloAfM02xzb0FW3Paa99yedzYV+kq4uf4=
+github.com/stretchr/testify v1.9.0 h1:HtqpIVDClZ4nwg75+f6Lvsy/wHu+3BoSGCbBAcpTsTg=
+github.com/stretchr/testify v1.9.0/go.mod h1:r2ic/lqez/lEtzL7wO/rwa5dbSLXVDPFyf8C91i36aY=
+github.com/ugorji/go/codec v1.2.7 h1:YPXUKf7fYbp/y8xloBqZOw2qaVggbfwMlI8WM3wZUJ0=
+github.com/ugorji/go/codec v1.2.7/go.mod h1:WGN1fab3R1fzQlVQTkfxVtIBhWDRqOviHU95kRgeqEY=
+github.com/yosida95/uritemplate/v3 v3.0.2 h1:Ed3Oyj9yrmi9087+NczuL5BwkIc4wvTb5zIM+UJPGz4=
+github.com/yosida95/uritemplate/v3 v3.0.2/go.mod h1:ILOh0sOhIJR3+L/8afwt/kE++YT040gmv5BQTMR2HP4=
+golang.org/x/net v0.33.0 h1:74SYHlV8BIgHIFC/LrYkOGIwL19eTYXQ5wc6TBuO36I=
+golang.org/x/net v0.33.0/go.mod h1:HXLR5J+9DxmrqMwG9qjGCxZ+zKXxBru04zlTvWlWuN4=
+golang.org/x/time v0.6.0 h1:eTDhh4ZXt5Qf0augr54TN6suAUudPcawVZeIAPU7D4U=
+golang.org/x/time v0.6.0/go.mod h1:3BpzKBy/shNhVucY/MWOyx10tF3SFh9QdLuxbVysPQM=
+gopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=
+gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk=
+gopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q=
+gopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=
+gopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=

go.sum

@@ -0,0 +1,35 @@
+package config
+
+import (
+	"fmt"
+	"os"
+)
+
+type Config struct {
+	ServerName string
+	Version    string
+	OpenAPIURL string
+	BaseURL    string
+	Token      string
+}
+
+func NewConfig() (*Config, error) {
+	token := os.Getenv("ALAPI_TOKEN")
+	if token == "" {
+		return nil, fmt.Errorf("ALAPI_TOKEN environment variable is required")
+	}
+
+	apiID := os.Getenv("ALAPI_API_ID")
+	openAPIURL := "https://v3.alapi.cn/openapi.json"
+	if apiID != "" {
+		openAPIURL = fmt.Sprintf("https://v3.alapi.cn/openapi/%s.json", apiID)
+	}
+
+	return &Config{
+		ServerName: "ALAPI MCP Server",
+		Version:    "1.0.0",
+		OpenAPIURL: openAPIURL,
+		BaseURL:    "https://v3.alapi.cn",
+		Token:      token,
+	}, nil
+}

internal/config/config.go

@@ -0,0 +1,62 @@
+package handler
+
+import (
+	"context"
+	"encoding/json"
+	"fmt"
+	"mcp-alapi-cn/internal/models"
+
+	"github.com/go-resty/resty/v2"
+	"github.com/mark3labs/mcp-go/mcp"
+)
+
+type ToolHandler struct {
+	baseURL string
+	token   string
+	client  *resty.Client
+}
+
+func NewToolHandler(baseURL string, token string) *ToolHandler {
+	return &ToolHandler{
+		baseURL: baseURL,
+		token:   token,
+		client:  resty.New(),
+	}
+}
+
+func (h *ToolHandler) Handle(ctx context.Context, request mcp.CallToolRequest) (*mcp.CallToolResult, error) {
+	arguments := request.Params.Arguments
+	uri := request.Params.Name
+
+	marshal, err := json.Marshal(arguments)
+	if err != nil {
+		return nil, fmt.Errorf("marshal request failed: %w", err)
+	}
+
+	response, err := h.client.SetBaseURL(h.baseURL).R().
+		SetHeader("Content-Type", "application/json").
+		SetHeader("token", h.token).
+		SetHeader("User-Agent", "ALAPI-SDK/MCP-SERVER v1.0.0").
+		SetBody(marshal).
+		Post(uri)
+	if err != nil {
+		return nil, fmt.Errorf("API request failed: %w", err)
+	}
+
+	// 解析基础响应
+	var baseResp models.BaseResponse
+	if err := json.Unmarshal(response.Body(), &baseResp); err != nil {
+		return nil, fmt.Errorf("unmarshal response failed: %w", err)
+	}
+	if baseResp.Code != 200 {
+		return nil, fmt.Errorf("api response failed:%s", baseResp.Message)
+	}
+
+	// 只返回 data 部分的数据
+	dataJSON, err := json.Marshal(baseResp.Data)
+	if err != nil {
+		return nil, fmt.Errorf("marshal response data failed: %w", err)
+	}
+
+	return mcp.NewToolResultText(string(dataJSON)), nil
+}

internal/handler/tool_handler.go

@@ -0,0 +1,11 @@
+package models
+
+// BaseResponse 基础响应结构
+type BaseResponse struct {
+	Code      int         `json:"code"`
+	RequestID string      `json:"request_id"`
+	Message   string      `json:"message"`
+	Time      int64       `json:"time"`
+	Usage     int         `json:"usage"`
+	Data      interface{} `json:"data"`
+}