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.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP InternalFind 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 install2. 建置
pnpm build3. 本地開發
# 設定環境變數
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.shThin 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 (本地)
變數 | 說明 |
| 員工 FX-CRM User ID（格式： |
| Cloud Run Backend URL |
Cloud Run (GCP Secret Manager)
變數 | 說明 |
| FX-CRM App ID |
| FX-CRM App Secret |
| FX-CRM Permanent Code |
| FX-CRM Corp ID |
| Odoo URL |
| Odoo 資料庫名稱 |
| Odoo API Key |
| Odoo 用戶 ID |
| Shopify 商店名稱 |
| Shopify Access Token |
| GitHub Personal Access Token |
| 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