summaryrefslogtreecommitdiff
path: root/panto_mcp/config.lua
diff options
context:
space:
mode:
authort <t@tjp.lol>2026-11-17 00:53:11 -0700
committert <t@tjp.lol>2026-11-17 15:42:02 -0700
commit413d9a4b241a0f4111e39fdc0059ac15069d034f (patch)
tree55f416467d7d1f1c6a36e875c3dd60e14874a1b0 /panto_mcp/config.lua
Establish panto-mcp baselineHEADv0.1.0main
Diffstat (limited to 'panto_mcp/config.lua')
-rw-r--r--panto_mcp/config.lua176
1 files changed, 176 insertions, 0 deletions
diff --git a/panto_mcp/config.lua b/panto_mcp/config.lua
new file mode 100644
index 0000000..2a88c9c
--- /dev/null
+++ b/panto_mcp/config.lua
@@ -0,0 +1,176 @@
+local json = require('panto').ext.json
+local M = {}
+local function string_ok(v) return type(v) == 'string' and not v:find('%z') end
+function M.expand(s, root, getenv)
+ return (s:gsub('%${env:([%w_]+)}', function(k) return (getenv or os.getenv)(k) or '' end)
+ :gsub('%${project_root}', function() return root end))
+end
+function M.canonical(v) return json.encode(v) end
+function M.hash(s)
+ local h = 2166136261
+ for i = 1, #s do h = ((h ~ s:byte(i)) * 16777619) & 0xffffffff end
+ return string.format('%08x', h)
+end
+function M.fingerprint(s)
+ return M.hash(M.canonical({url=s.url, command=s.command, args=s.args, env=s.env,
+ cwd=s.cwd, headers=s.headers, auth=s.auth, oauth=s.oauth}))
+end
+local function tool_hash(name) return M.hash(name)..M.hash(name:reverse()) end
+function M.valid_name(s)
+ return type(s)=='string' and s:match('^[A-Za-z0-9_-]+$')~=nil
+ and not s:find('__',1,true) and s:sub(-1)~='_'
+end
+function M.tool_name(server,name)
+ local server_part=server
+ if #server_part>32 then server_part=server_part:sub(1,15)..'-'..tool_hash(server_part) end
+ local prefix='mcp.'..server_part..'.'
+ local stem=name:gsub('[^A-Za-z0-9_-]','_'):gsub('__+','_')
+ local available=64-(#prefix+2)
+ -- Reserve encoded-looking suffixes so a literal name cannot impersonate a sanitized one.
+ if stem:match('%-'..string.rep('%x',16)..'$') then stem=stem..'_' end
+ if stem==name and #stem<=available then return prefix..stem end
+ local suffix='-'..tool_hash(name)
+ stem=stem:sub(1,math.max(1,available-#suffix))
+ return prefix..stem..suffix
+end
+local function list(v, field)
+ if v == nil then return {} end
+ assert(type(v)=='table', field .. ' must be an array')
+ local count = 0
+ for k,x in pairs(v) do
+ assert(type(k)=='number' and k>=1 and k%1==0 and string_ok(x), field .. ' must contain strings')
+ count = count+1
+ end
+ assert(count == #v, field .. ' must be dense')
+ return v
+end
+local function map(v, field)
+ if v == nil then return {} end
+ assert(type(v)=='table', field .. ' must be a table')
+ for k,x in pairs(v) do assert(string_ok(k) and string_ok(x), field .. ' must map strings to strings') end
+ return v
+end
+local forbidden_headers={host=true,connection=true,['content-length']=true,['transfer-encoding']=true,
+ expect=true,upgrade=true,te=true,['keep-alive']=true,['proxy-connection']=true}
+local sensitive_headers={authorization=true,['proxy-authorization']=true,cookie=true,['x-api-key']=true,
+ ['api-key']=true,['x-auth-token']=true,['x-access-token']=true}
+local function loopback_url(url)
+ local authority=url:match('^[Hh][Tt][Tt][Pp]://([^/?#]+)')
+ if not authority then return false end
+ authority=authority:match('@(.+)$') or authority
+ local host
+ if authority:sub(1,1)=='[' then host=authority:match('^(%b[])')
+ else host=authority:match('^([^:]+)') end
+ if not host then return false end
+ local lower=host:lower()
+ if lower=='localhost' or lower=='[::1]' or lower=='::1' then return true end
+ local a,b,c,d=lower:match('^(%d+)%.(%d+)%.(%d+)%.(%d+)$')
+ if not a then return false end
+ for _,octet in ipairs({a,b,c,d}) do if #octet>1 and octet:sub(1,1)=='0' then return false end end
+ a,b,c,d=tonumber(a),tonumber(b),tonumber(c),tonumber(d)
+ return a==127 and b<256 and c<256 and d<256
+end
+local function header_token(s)
+ if type(s)~='string' or s=='' then return false end
+ for i=1,#s do
+ local c=s:sub(i,i)
+ if not c:match('^[A-Za-z0-9]$') and not ("!#$%&'*+-.^_`|~"):find(c,1,true) then return false end
+ end
+ return true
+end
+local function empty_env_expansion(value,getenv)
+ for key in value:gmatch('%${env:([%w_]+)}') do
+ local expanded=(getenv or os.getenv)(key)
+ if expanded==nil or expanded=='' then return true end
+ end
+ return false
+end
+local function glob(pattern, s)
+ local p = pattern:gsub('([%^%$%(%)%%%.%[%]%+%-])', '%%%1'):gsub('%*', '.*'):gsub('%?', '.')
+ return s:match('^' .. p .. '$') ~= nil
+end
+function M.tool_enabled(cfg, name)
+ local enabled = #cfg.enabled_tools == 0
+ for _,p in ipairs(cfg.enabled_tools) do if glob(p,name) then enabled = true end end
+ for _,p in ipairs(cfg.disabled_tools) do if glob(p,name) then return false end end
+ return enabled
+end
+function M.parse(raw, dirs, getenv)
+ local warnings, servers = {}, {}
+ if raw~=nil and type(raw)~='table' then warnings[#warnings+1]='mcp must be a table' end
+ raw = type(raw)=='table' and raw or {}
+ local settings = {}
+ for k,default in pairs({startup_timeout_ms=30000, call_timeout_ms=300000, idle_timeout_ms=60000}) do
+ local v = raw[k] or default
+ if type(v)~='number' or v<1 or v%1~=0 then warnings[#warnings+1]=k .. ': using default'; v=default end
+ settings[k]=v
+ end
+ local root = (dirs and dirs.project_root) or require('luv').cwd()
+ local function expand(v) return M.expand(v, root, getenv) end
+ if raw.servers ~= nil and type(raw.servers)~='table' then warnings[#warnings+1]='servers must be a table'; return settings,servers,warnings end
+ for name, raw_server in pairs(raw.servers or {}) do
+ local ok, s = pcall(function()
+ assert(M.valid_name(name), 'invalid server name')
+ assert(type(raw_server)=='table', 'server must be a table')
+ local r = raw_server
+ assert(r.enabled == nil or type(r.enabled)=='boolean', 'enabled must be boolean')
+ if r.enabled == false then return nil end
+ assert((r.url~=nil) ~= (r.command~=nil), 'configure exactly one of url / command')
+ local c = {name=name, expose=r.expose or 'search', enabled=true}
+ assert(c.expose=='search' or c.expose=='eager', 'expose must be search or eager')
+ for _,k in ipairs({'url','command','cwd','auth'}) do
+ if r[k]~=nil then assert(string_ok(r[k]) and r[k]~='', k .. ' must be a nonempty string'); c[k]=expand(r[k]) end
+ end
+ if c.command then assert(c.command~='', 'command expanded to empty') end
+ if c.url then assert(c.url:match('^https?://'), 'url must use http(s)') end
+ if c.url and c.url:match('^http://') and c.auth and not loopback_url(c.url) then
+ warnings[#warnings+1]=name .. ': named auth on non-loopback HTTP is forbidden; server ignored'
+ return nil
+ end
+ if r.oauth~=nil then
+ assert(c.url and type(r.oauth)=='table', 'oauth requires an HTTP server and a table')
+ c.oauth={scopes=list(r.oauth.scopes,'oauth.scopes')}
+ for _,key in ipairs({'client_id','client_secret','issuer'}) do
+ if r.oauth[key]~=nil then
+ assert(string_ok(r.oauth[key]) and r.oauth[key]~='', 'oauth.'..key..' must be a nonempty string')
+ c.oauth[key]=expand(r.oauth[key])
+ assert(c.oauth[key]~='', 'oauth.'..key..' expanded to empty')
+ end
+ end
+ assert(not c.oauth.client_secret or c.oauth.client_id, 'oauth.client_secret requires client_id')
+ assert(not c.oauth.client_id or c.oauth.issuer, 'oauth.client_id requires oauth.issuer')
+ end
+ c.args={}; for _,v in ipairs(list(r.args,'args')) do c.args[#c.args+1]=expand(v) end
+ c.env={}; for k,v in pairs(map(r.env,'env')) do
+ assert(k~='' and not k:find('=',1,true), 'invalid environment name'); c.env[k]=expand(v)
+ end
+ c.headers={}
+ for k,v in pairs(map(r.headers,'headers')) do
+ local lower=k:lower()
+ if not header_token(k) then warnings[#warnings+1]=name .. ': invalid HTTP header name ignored'
+ elseif forbidden_headers[lower] or (lower=='authorization' and c.auth~=nil) then warnings[#warnings+1]=name .. ': core-forbidden HTTP header ignored'
+ elseif c.url and c.url:match('^http://') and not loopback_url(c.url) and sensitive_headers[lower] then
+ warnings[#warnings+1]=name .. ': sensitive header on non-loopback HTTP ignored'
+ elseif empty_env_expansion(v,getenv) then warnings[#warnings+1]=name .. ': header has an empty env expansion and was ignored'
+ else
+ local value=expand(v)
+ if (k..value):find('[\r\n]') then warnings[#warnings+1]=name .. ': unsafe HTTP header ignored'
+ else c.headers[k]=value end
+ end
+ end
+ c.enabled_tools=list(r.enabled_tools,'enabled_tools'); c.disabled_tools=list(r.disabled_tools,'disabled_tools')
+ c.cwd=c.cwd or root
+ if c.cwd:sub(1,1)~='/' then c.cwd=root .. '/' .. c.cwd end
+ c.transport=c.url and 'http' or 'stdio'
+ c.fingerprint=M.fingerprint(c)
+ return c
+ end)
+ if not ok then warnings[#warnings+1]=tostring(name) .. ': ' .. tostring(s)
+ elseif s then
+ servers[name]=s
+
+ end
+ end
+ return settings, servers, warnings
+end
+return M