1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
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
|