Token导航 LogoToken导航TokenDH.com
Ohio Bmv SQL MCP logo
数据服务stdio官方级别未说明来源级核验

Ohio Bmv SQL MCP

MCP Server

一个基于Azure Functions和Azure SQL的MCP服务器,用于处理俄亥俄州机动车管理局驾照地址变更请求,通过自然语言交互实现数据收集、验证和存储。

工具数

1

提示词数

0

GitHub Stars

0

资源数

0
Bicep自然语言处理CursorCursorVS Code

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

作者 / 组织

john-carroll-sw

提供方

john-carroll-sw

最后核验

2026/5/17 20:19

快速接入

先看主来源和安装命令,再打开仓库或文档;下面只保留这个条目的关键接入事实。

命令预览

pip install -r requirements.txt

详细介绍

俄亥俄州BMV许可证地址更改-MCP服务器

这是一个MCP(模型上下文协议)服务器,使AI助手能够捕获和处理俄亥俄州驾照地址更改请求。它使用Azure Functions(Python)和Azure SQL数据库构建,演示了会话式AI如何与结构化数据库系统交互以处理政府服务请求。

业务背景

这种概念验证使AI助手(ChatGPT、GitHub Copilot或自定义代理)能够:

  • 通过自然对话收集所需信息
  • 验证地址更改数据
  • 将请求直接持久化到Azure SQL数据库
  • 向用户提供确认

用例: 一位市民告诉人工智能助手他们已经搬家了,助手通过调用此MCP工具将信息存储在BMV的系统中,指导他们更新驾照地址。

](https://codespaces.new/Azure-Samples/remote-mcp-functions-python)

以下是使用Azure Functions的远程MCP服务器的架构图:

Architecture Diagram

先决条件

- Visual Studio Code - Azure功能扩展

SQL数据库集成的其他先决条件

此项目使用ODBC连接到Azure SQL数据库。您需要安装SQL Server的Microsoft ODBC驱动程序:

macOS:

brew tap microsoft/mssql-release https://github.com/Microsoft/homebrew-mssql-release
brew update
brew install msodbcsql18 unixodbc

Linux(Ubuntu/Debian):

curl https://packages.microsoft.com/keys/microsoft.asc | sudo apt-key add -
curl https://packages.microsoft.com/config/ubuntu/$(lsb_release -rs)/prod.list | sudo tee /etc/apt/sources.list.d/mssql-release.list
sudo apt-get update
sudo ACCEPT_EULA=Y apt-get install -y msodbcsql18 unixodbc-dev

窗户:

从下载并安装 SQL Server的Microsoft ODBC驱动程序

准备好当地环境

与基础模板不同,此项目 不需要Azurite (Azure存储模拟器),因为它只使用Azure SQL数据库进行数据持久化。

从终端本地运行MCP服务器

  1. 在新的终端窗口中切换到src文件夹:
   cd src
  1. 安装Python依赖项:
   pip install -r requirements.txt
备注 在执行以下操作之前创建虚拟环境是一种最佳做法 pip install 以避免依赖关系问题/冲突,或者如果您在CodeSpaces中运行。看 VS代码中的Python环境 了解更多信息。
  1. 在本地启动Functions主机:
   func start
备注 默认情况下,这将使用webhooks路由: /runtime/webhooks/mcp/sse稍后,我们将在Azure中使用它来设置客户端/主机调用的密钥: /runtime/webhooks/mcp/sse?code=

连接到 *本地* 来自客户端/主机的MCP服务器

VS代码-副驾驶代理模式

  1. 添加MCP服务器 从命令面板中,将URL添加到正在运行的Function应用程序的SSE端点:
   http://0.0.0.0:7071/runtime/webhooks/mcp/sse
  1. 列出MCP服务器 从命令面板启动服务器
  1. 在Copilot聊天代理模式下,输入提示以触发工具:
   I moved from 123 Old Street, Columbus, OH 43215 to 456 New Avenue, Dayton, OH 45402. 
   Please update my Ohio driver's license address. My license number is OH12345678 and 
   my date of birth is June 15, 1985.
  1. 当系统提示运行该工具时,点击同意 继续
  1. 完成后,在终端窗口中按Ctrl+C停止Functions主机进程。

MCP检查员

  1. 在一个 新终端窗口,安装并运行MCP检查器
   npx @modelcontextprotocol/inspector
  1. 从显示的URL打开MCP Inspector web应用程序(例如。, )
  1. 将运输类型设置为 SSE
  1. 将URL设置为正在运行的Function应用程序的SSE端点,然后 连接:
   http://0.0.0.0:7071/runtime/webhooks/mcp/sse

> 备注 此步骤在CodeSpaces中不起作用。请继续部署到远程MCP。

  1. 列出工具.点击 create_license_address_change_request运行工具 与测试数据。

在Azure SQL中验证数据

成功运行该工具后,您可以验证地址更改请求是否已存储:

  1. 登录Azure门户()
  1. 导航到Azure SQL数据库(俄亥俄州bmv演示数据库)
  1. 首选 查询编辑器 (或使用SQL Server Management Studio)
  1. 运行以下查询:
   SELECT TOP 10 * FROM dbo.LicenseAddressChangeRequests ORDER BY CreatedAt DESC;
  1. 验证您的测试数据是否出现在结果中

部署到Azure以实现远程MCP

运行这个 雅匝德 命令为功能应用程序配置任何所需的Azure资源,并部署您的代码:

azd up

您可以选择加入示例中使用的ExpressRoute。为此,请先执行此操作 azd up

azd env set VNET_ENABLED true

此外,API管理\]可用于改善MCP服务器的安全性和策略,以及 App Service内置身份验证 可用于设置您最喜欢的OAuth提供程序,包括Entra。

连接到您的 *远程* 来自客户端的MCP服务器功能应用程序

您的客户端将需要一个密钥来调用新的托管SSE端点,其格式为 https://.azurewebsites.net/runtime/webhooks/mcp/sse默认情况下,托管功能需要一个系统密钥,可以从 门户 或CLI(az functionapp keys list --resource-group --name ).获取名为的系统密钥 mcp_extension.

在MCP Inspector中连接到远程MCP服务器

对于MCP检查器,您可以在URL中包含密钥:

https://.azurewebsites.net/runtime/webhooks/mcp/sse?code=

在VS Code中连接到远程MCP服务器-GitHub Copilot

对于VS Code中的GitHub Copilot,您应该将密钥设置为 x-functions-key 标题在 mcp.json,你只需使用 https://.azurewebsites.net/runtime/webhooks/mcp/sse 以下示例使用输入,并在从VS Code启动服务器时提示您提供密钥。备注 mcp.json 已包含在此仓库中,并将由VS Code获取。单击服务器上的“开始”,系统将提示输入以下值 functionapp-name (在您的/.alue/\*/env文件中)和 functions-mcp-extension-system-key 可以从上面的CLI命令或Function App门户中的API密钥中获取。

{
    "inputs": [
        {
            "type": "promptString",
            "id": "functions-mcp-extension-system-key",
            "description": "Azure Functions MCP Extension System Key",
            "password": true
        },
        {
            "type": "promptString",
            "id": "functionapp-name",
            "description": "Azure Functions App Name"
        }
    ],
    "servers": {
        "remote-mcp-function": {
            "type": "sse",
            "url": "https://${input:functionapp-name}.azurewebsites.net/runtime/webhooks/mcp/sse",
            "headers": {
                "x-functions-key": "${input:functions-mcp-extension-system-key}"
            }
        },
        "local-mcp-function": {
            "type": "sse",
            "url": "http://0.0.0.0:7071/runtime/webhooks/mcp/sse"
        }
    }
}

对于MCP检查器,您可以在URL中包含密钥: https://.azurewebsites.net/runtime/webhooks/mcp/sse?code=.

对于VS Code中的GitHub Copilot,您应该将密钥设置为 x-functions-key 标题在 mcp.json,你只需使用 https://.azurewebsites.net/runtime/webhooks/mcp/sse 以下示例使用输入,当您从VS Code启动服务器时,将提示您提供密钥:

{
    "inputs": [
        {
            "type": "promptString",
            "id": "functions-mcp-extension-system-key",
            "description": "Azure Functions MCP Extension System Key",
            "password": true
        }
    ],
    "servers": {
        "my-mcp-server": {
            "type": "sse",
            "url": ".azurewebsites.net/runtime/webhooks/mcp/sse",
            "headers": {
                "x-functions-key": "${input:functions-mcp-extension-system-key}"
            }
        }
    }
}

重新部署代码

你可以运行 azd up 根据需要多次执行命令,以配置Azure资源并将代码更新部署到功能应用程序。

\[!注意\] 部署的代码文件总是被最新的部署包覆盖。

清理资源

使用完功能应用程序和相关资源后,您可以使用此命令从Azure中删除功能应用程序及其相关资源,从而避免产生任何进一步的成本:

azd down

有用的Azure命令

部署应用程序后,您可以使用以下命令来管理和监视应用程序:

# Get your function app name from the environment file
FUNCTION_APP_NAME=$(cat .azure/$(cat .azure/config.json | jq -r '.defaultEnvironment')/env.json | jq -r '.FUNCTION_APP_NAME')
echo $FUNCTION_APP_NAME

# Get resource group 
RESOURCE_GROUP=$(cat .azure/$(cat .azure/config.json | jq -r '.defaultEnvironment')/env.json | jq -r '.AZURE_RESOURCE_GROUP')
echo $RESOURCE_GROUP

# View function app logs
az webapp log tail --name $FUNCTION_APP_NAME --resource-group $RESOURCE_GROUP

# Redeploy the application without provisioning new resources
azd deploy

源代码

许可证地址更改端点的功能代码在中定义 src/function_app.pyMCP函数注释将此函数公开为可由AI代理对话调用的MCP服务器工具。

下面是function_app.py的主要函数:

@app.generic_trigger(
    arg_name="context",
    type="mcpToolTrigger",
    toolName="create_license_address_change_request",
    description="Create an Ohio BMV driver's license address-change request record in SQL.",
    toolProperties=tool_properties_create_license_json
)
def create_license_address_change_request(context) -> str:
    """
    Creates an address change request for an Ohio driver's license in Azure SQL.
    
    Args:
        context: The trigger context containing all address change parameters.
        
    Returns:
        str: A success message with the driver license number or an error message.
    """
    try:
        # Parse the context to extract address change parameters
        dln = context.get("driverLicenseNumber")
        dob = context.get("dateOfBirth")
        first = context.get("firstName")
        middle = context.get("middleName")
        last = context.get("lastName")
        
        old_addr1 = context.get("oldAddressLine1")
        old_addr2 = context.get("oldAddressLine2")
        old_city = context.get("oldCity")
        old_state = context.get("oldState")
        old_zip = context.get("oldZip")
        
        new_addr1 = context.get("newAddressLine1")
        new_addr2 = context.get("newAddressLine2")
        new_city = context.get("newCity")
        new_state = context.get("newState")
        new_zip = context.get("newZip")
        
        phone = context.get("phone")
        email = context.get("email")
        preferred_contact = context.get("preferredContactMethod")
        conversation_summary = context.get("conversationSummary")
        
        # Validate required fields
        if not all([dln, dob, first, last, old_addr1, old_city, old_state, 
                   old_zip, new_addr1, new_city, new_state, new_zip]):
            return "Error: Missing required fields for address change request."
        
        # Get database connection string
        connection_string = os.environ["SQL_CONNECTION_STRING"]
        
        # Connect and insert
        conn = pyodbc.connect(connection_string)
        cursor = conn.cursor()
        
        insert_sql = """
        INSERT INTO dbo.LicenseAddressChangeRequests 
        (DriverLicenseNumber, DateOfBirth, FirstName, MiddleName, LastName,
         OldAddressLine1, OldAddressLine2, OldCity, OldState, OldZip,
         NewAddressLine1, NewAddressLine2, NewCity, NewState, NewZip,
         Phone, Email, PreferredContactMethod, ConversationSummary)
        VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?);
        SELECT SCOPE_IDENTITY();
        """
        
        cursor.execute(insert_sql, (
            dln, dob, first, middle, last,
            old_addr1, old_addr2, old_city, old_state, old_zip,
            new_addr1, new_addr2, new_city, new_state, new_zip,
            phone, email, preferred_contact, conversation_summary
        ))
        
        result = cursor.fetchone()
        request_id = result[0] if result and result[0] else None
        
        conn.commit()
        cursor.close()
        conn.close()
        
        if request_id:
            return f"Successfully created address-change request (ID: {request_id}) for license {dln}."
        else:
            return f"Successfully created address-change request for license {dln}."
            
    except Exception as e:
        logging.error(f"Error creating address change request: {str(e)}")
        return f"Error: {str(e)}"

请注意 host.json 文件还包括对实验包的引用,这是使用此功能的应用程序所必需的:

"extensionBundle": {
  "id": "Microsoft.Azure.Functions.ExtensionBundle.Experimental",
  "version": "[4.*, 5.0.0)"
}

后续步骤

目录标签

目录标签

Bicep自然语言处理Cursor本地部署政府服务自动化AzureFunctionsSQL数据库集成AI辅助工具

支持客户端

CursorVS Code

接入字段

传输方式(transport,传输协议)

stdio

鉴权方式(authType,认证方式)

oauth

工具数量(toolCount,工具数)

1

资源数量(resourceCount,资源数)

0

提示词数量(promptCount,提示词数)

0

权限和风险

stdiooauth部署方式未说明

接入前请确认传输方式、认证方式和部署位置,并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限;先核对安装命令和配置内容。

来源信息

继续浏览同类 MCP