kiwonl/run-mcp-server

Currency MCP Server 💵

A simple MCP server that provides exchange rate information using the Frankfurter API.

Deploying the MCP Server on Cloud Run

1. Enable APIs (Cloud Run, Artifact Registry, Cloud Build)

   cd run-mcp-server
   

   gcloud services enable \
     run.googleapis.com \
     artifactregistry.googleapis.com \
     cloudbuild.googleapis.com
   

2. Deploy to Cloud Run

   gcloud run deploy currency-mcp-server \
       --no-allow-unauthenticated \
       --region=us-central1 \
       --source=.
   

Testing the MCP Server using the Gemini CLI in Cloud Shell

1. Add Cloud Run Invoker permission to the Cloud Shell User

   gcloud projects add-iam-policy-binding $GOOGLE_CLOUD_PROJECT \
       --member=user:$(gcloud config get-value account) \
       --role='roles/run.invoker'
   

2. Declare environment variables

   # Get the service URL from the deployed Cloud Run service
   export MCP_SERVER_URL=$(gcloud run services describe currency-mcp-server --region=us-central1 --format="value(status.url)")
   
   # Get an identity token for authentication
   export ID_TOKEN=$(gcloud auth print-identity-token)
   

3. Configure the MCP server in the Gemini CLI

   cat <<EOF > ~/.gemini/settings.json
   {
     "selectedAuthType": "cloud-shell", // only cloudshell
     "mcpServers": {
       "exchange-mcp-server": {
         "httpUrl": "${MCP_SERVER_URL}/mcp",
         "headers": {
           "Authorization": "Bearer ${ID_TOKEN}"
         }
       }
     }
   }
   EOF
   

4. Test in the Gemini CLI

   USD 에서 KRW 로의 환율을 알려주세요
   

   

5. References

   • Currency Agent Codelab
   • How to deploy a secure MCP server on Cloud Run Codelab