Which integrations are available for this server?

Provides integration with GitHub's API for programmatic access and management of repository resources. Provides tools for interacting with Odoo's API to search, read, count, create, update, and delete records. Enables searching and retrieving products, updating product information and pricing, and accessing inventory locations within Shopify.

How do I use MCP Internal?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MCP Internal Find the technical specifications for the ceramic tiles in our knowledge base" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

MCP Internal

元心建材內部 MCP 整合系統 - 雙層架構

架構

┌─────────────────────────────────────────────────────────────────┐ │ 員工電腦 │ │ ┌───────────┐ ┌─────────────────────────────────────────┐ │ │ │ Claude │────▶│ Thin Client (MCP Server) │ │ │ │ Code │ │ - 無 API Keys │ │ │ └───────────┘ │ - 只有 FSUID (員工 FX-CRM ID) │ │ │ │ - 只做請求轉發 │ │ │ └──────────────┬──────────────────────────┘ │ └───────────────────────────────────│─────────────────────────────┘ │ HTTPS + Bearer Token ▼ ┌─────────────────────────────────────────────────────────────────┐ │ Google Cloud (asia-east1) │ │ ┌─────────────────────────────────────────────────────────┐ │ │ │ Cloud Run (mcp-internal-backend) │ │ │ │ 1. FSUID 驗證 → 查 FX-CRM PersonnelObj │ │ │ │ 2. 取得用戶資訊 + mcp_permission__c │ │ │ │ 3. 權限檢查 │ │ │ │ 4. API 呼叫 (Odoo/Shopify/GitHub) │ │ │ └──────────────────────────────────────────────────────────┘ │ └─────────────────────────────────────────────────────────────────┘

專案結構

mcp-internal/ ├── packages/ │ ├── thin-client/ # 本地 MCP Server │ ├── cloud-backend/ # Cloud Run 後端 │ └── shared/ # 共用型別 ├── infrastructure/ # 部署腳本 └── pnpm-workspace.yaml

快速開始

1. 安裝依賴

pnpm install

2. 建置

pnpm build

3. 本地開發

# 設定環境變數 cp .env.example .env # 編輯 .env 填入必要的值 # 啟動 Cloud Backend (開發模式) cd packages/cloud-backend pnpm dev # 在另一個終端啟動 Thin Client cd packages/thin-client pnpm dev

部署

Cloud Run Backend

# 設定 GCP Secrets (首次) ./infrastructure/setup-secrets.sh # 部署 ./infrastructure/deploy.sh

Thin Client (員工設定)

{ "mcpServers": { "mcp-internal": { "command": "npx", "args": ["-y", "github:jameslai-sparkofy/mcp-internal#master"], "env": { "FSUID": "FSUID_xxxxx", "CLOUD_RUN_URL": "https://mcp-internal-backend-xxx.a.run.app" } } } }

認證機制

員工從 FX-CRM 取得自己的 FSUID（格式：FSUID_xxxxx）
員工將 FSUID 設定在本地 MCP 環境變數
每次請求帶上 FSUID → Cloud Run 驗證
Cloud Run 用 FSUID 查 FX-CRM PersonnelObj → 取得用戶資訊 + 權限

環境變數

Thin Client (本地)

變數	說明
`FSUID`	員工 FX-CRM User ID（格式：`FSUID_xxxxx`）
`CLOUD_RUN_URL`	Cloud Run Backend URL

Cloud Run (GCP Secret Manager)

變數	說明
`FXCRM_APP_ID`	FX-CRM App ID
`FXCRM_APP_SECRET`	FX-CRM App Secret
`FXCRM_PERMANENT_CODE`	FX-CRM Permanent Code
`FXCRM_CORP_ID`	FX-CRM Corp ID
`ODOO_URL`	Odoo URL
`ODOO_DB`	Odoo 資料庫名稱
`ODOO_API_KEY`	Odoo API Key
`ODOO_USER_ID`	Odoo 用戶 ID
`SHOPIFY_STORE`	Shopify 商店名稱
`SHOPIFY_ACCESS_TOKEN`	Shopify Access Token
`GITHUB_TOKEN`	GitHub Personal Access Token
`GITHUB_OWNER`	GitHub Owner

可用工具

Odoo

odoo_search - 搜尋記錄
odoo_read - 讀取記錄
odoo_count - 計算記錄數
odoo_create - 建立記錄 (admin/assistant)
odoo_update - 更新記錄 (admin/assistant)
odoo_delete - 刪除記錄 (admin/assistant)

Shopify

shopify_search_products - 搜尋產品
shopify_get_product - 取得產品
shopify_update_product - 更新產品 (admin/assistant)
shopify_update_price - 更新價格 (admin/assistant)
shopify_get_locations - 取得庫存位置

知識庫

knowledge_search - 搜尋知識庫
knowledge_get_file - 讀取檔案
knowledge_list_directory - 列出目錄
knowledge_get_price - 查詢價格
knowledge_search_spec - 搜尋規格

License

MIT

MCP Internal

MCP Internal

架構

專案結構

快速開始

1. 安裝依賴

2. 建置

3. 本地開發

部署

Cloud Run Backend

Thin Client (員工設定)

認證機制

環境變數

Thin Client (本地)

Cloud Run (GCP Secret Manager)

可用工具

Odoo

Shopify

知識庫

License

Resources

New MCP Servers

Latest Blog Posts

MCP directory API