Byteland
A night city of developers: search people and projects, read project rooms, see who is live.
我该使用它吗
质量与安全性
发现（1）
- LOWTool 'get_project' description lacks action verb在 get_project 中
基于对工具定义和协议合规性的自动分析。
上下文开销
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中：
{
"mcpServers": {
"byteland": {
"url": "https://byteland.dev/mcp"
}
}
}远程端点
https://byteland.dev/mcpstreamable-http它能做什么
工具清单
工具（14）
⚪about
Short description of Byteland: what buildings, rooms and lights stand for, units, privacy rules and supported languages. A good first call.
输入模式
{
"type": "object",
"properties": {}
}🟢get_street(seed, mode, from, to, lang)
Buildings in a range (owner, type, floors, light counts) and gaps (alleys, empty lots). Positions in centimetres, at most 80000 cm.
输入模式
{
"type": "object",
"properties": {
"seed": {
"type": "string",
"description": "Street seed. Default: gece-sehri."
},
"mode": {
"type": "string",
"enum": [
"kume",
"bos",
"ornek"
],
"description": "kume (default): the founder’s real building with vacant buildings; bos: topic city, everyone vacant; ornek: demo street full of sample profiles."
},
"from": {
"type": "number",
"description": "Start x (cm). Default -3000."
},
"to": {
"type": "number",
"description": "End x (cm). Default 12000."
},
"lang": {
"type": "string",
"enum": [
"en",
"tr",
"es",
"pt",
"fr",
"de",
"it",
"nl",
"pl",
"ru",
"uk",
"ar",
"hi",
"id",
"zh",
"ja",
"ko"
],
"description": "Language of text fields (recipe, badges, topic names). Default: en."
}
}
}🟢get_building(ref, seed, mode, lang)
Public detail of one building: the owner’s profile, rooms and their states, machine-readable parts and the building recipe.
输入模式
{
"type": "object",
"properties": {
"ref": {
"type": [
"string",
"number"
],
"description": "Door number (e.g. 5) or username (e.g. \"@kaanisthatyou\")."
},
"seed": {
"type": "string",
"description": "Street seed. Default: gece-sehri."
},
"mode": {
"type": "string",
"enum": [
"kume",
"bos",
"ornek"
],
"description": "kume (default): the founder’s real building with vacant buildings; bos: topic city, everyone vacant; ornek: demo street full of sample profiles."
},
"lang": {
"type": "string",
"enum": [
"en",
"tr",
"es",
"pt",
"fr",
"de",
"it",
"nl",
"pl",
"ru",
"uk",
"ar",
"hi",
"id",
"zh",
"ja",
"ko"
],
"description": "Language of text fields (recipe, badges, topic names). Default: en."
}
},
"required": [
"ref"
]
}🟢get_profile(handle, seed, mode, github, lang)
A developer’s or company’s profile: bio, links (GitHub, website, socials), badges, projects and open-source contributions. If not on the street, looks for a saved profile, then GitHub; otherwise generates a sample (preview:true).
输入模式
{
"type": "object",
"properties": {
"handle": {
"type": "string",
"description": "Username, with or without @."
},
"seed": {
"type": "string",
"description": "Street seed. Default: gece-sehri."
},
"mode": {
"type": "string",
"enum": [
"kume",
"bos",
"ornek"
],
"description": "kume (default): the founder’s real building with vacant buildings; bos: topic city, everyone vacant; ornek: demo street full of sample profiles."
},
"github": {
"type": "boolean",
"description": "Look up GitHub’s public data. Default: true."
},
"lang": {
"type": "string",
"enum": [
"en",
"tr",
"es",
"pt",
"fr",
"de",
"it",
"nl",
"pl",
"ru",
"uk",
"ar",
"hi",
"id",
"zh",
"ja",
"ko"
],
"description": "Language of text fields (recipe, badges, topic names). Default: en."
}
},
"required": [
"handle"
]
}🟢list_projects(handle, seed, mode, github, lang)
A profile’s projects: state, description, stack, links (repo, site) plus open-source contributions. Private projects appear only as hidden:true.
输入模式
{
"type": "object",
"properties": {
"handle": {
"type": "string"
},
"seed": {
"type": "string",
"description": "Street seed. Default: gece-sehri."
},
"mode": {
"type": "string",
"enum": [
"kume",
"bos",
"ornek"
],
"description": "kume (default): the founder’s real building with vacant buildings; bos: topic city, everyone vacant; ornek: demo street full of sample profiles."
},
"github": {
"type": "boolean",
"description": "Look up GitHub’s public data. Default: true."
},
"lang": {
"type": "string",
"enum": [
"en",
"tr",
"es",
"pt",
"fr",
"de",
"it",
"nl",
"pl",
"ru",
"uk",
"ar",
"hi",
"id",
"zh",
"ja",
"ko"
],
"description": "Language of text fields (recipe, badges, topic names). Default: en."
}
},
"required": [
"handle"
]
}🟢get_project(handle, project, seed, mode, github, ...)
A single project of a profile. Returns nothing for private projects.
输入模式
{
"type": "object",
"properties": {
"handle": {
"type": "string"
},
"project": {
"type": "string",
"description": "Project name or id."
},
"seed": {
"type": "string",
"description": "Street seed. Default: gece-sehri."
},
"mode": {
"type": "string",
"enum": [
"kume",
"bos",
"ornek"
],
"description": "kume (default): the founder’s real building with vacant buildings; bos: topic city, everyone vacant; ornek: demo street full of sample profiles."
},
"github": {
"type": "boolean",
"description": "Look up GitHub’s public data. Default: true."
},
"lang": {
"type": "string",
"enum": [
"en",
"tr",
"es",
"pt",
"fr",
"de",
"it",
"nl",
"pl",
"ru",
"uk",
"ar",
"hi",
"id",
"zh",
"ja",
"ko"
],
"description": "Language of text fields (recipe, badges, topic names). Default: en."
}
},
"required": [
"handle",
"project"
]
}🟢search(query, mode, radius, seed, lang)
Find people, projects and stacks across every resident of the city (people, projects, stacks), plus buildings on the street by username, name, project or technology (results). Private projects never appear.
输入模式
{
"type": "object",
"properties": {
"query": {
"type": "string"
},
"mode": {
"type": "string",
"enum": [
"kume",
"bos",
"ornek"
],
"description": "kume (default): the founder’s real building with vacant buildings; bos: topic city, everyone vacant; ornek: demo street full of sample profiles."
},
"radius": {
"type": "integer",
"minimum": 0,
"maximum": 12,
"description": "Street chunks to scan on both sides (1 chunk = 80 m). Default 4."
},
"seed": {
"type": "string",
"description": "Street seed. Default: gece-sehri."
},
"lang": {
"type": "string",
"enum": [
"en",
"tr",
"es",
"pt",
"fr",
"de",
"it",
"nl",
"pl",
"ru",
"uk",
"ar",
"hi",
"id",
"zh",
"ja",
"ko"
],
"description": "Language of text fields (recipe, badges, topic names). Default: en."
}
},
"required": [
"query"
]
}🟢popular(period)
The leaderboard: buildings by unique visits this week (or period: "all"), the most viewed projects and the newest residents. A visit counts once per person per day; owners do not count themselves.
输入模式
{
"type": "object",
"properties": {
"period": {
"type": "string",
"enum": [
"week",
"all"
]
}
}
}🟢get_stats(handle)
Unique visits (all time and this week), project views, weekly rank and the last 14 days for one username.
输入模式
{
"type": "object",
"properties": {
"handle": {
"type": "string"
}
},
"required": [
"handle"
]
}🟢list_rooms(handle)
The project rooms of a person that have been used (every public project of a resident has a room, open by default; one nobody wrote in is empty and not listed): mode (open or read-only), channels with message counts, forum threads, last activity and how many are in voice. Closed rooms and private projects never appear.
输入模式
{
"type": "object",
"properties": {
"handle": {
"type": "string",
"description": "Username, with or without @."
}
},
"required": [
"handle"
]
}🟢read_room(handle, project, channel, limit)
The latest messages of one channel of a project room (default: its first channel) and the forum threads (idea, review, question, announcement) with reply and reaction counts.
输入模式
{
"type": "object",
"properties": {
"handle": {
"type": "string"
},
"project": {
"type": "string",
"description": "Project id (the repository name for GitHub projects)."
},
"channel": {
"type": "string",
"description": "Channel name or id. Default: the first channel."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "How many recent messages. Default 30."
}
},
"required": [
"handle",
"project"
]
}🟢read_thread(handle, project, thread)
One forum thread of a project room with all of its replies and reactions.
输入模式
{
"type": "object",
"properties": {
"handle": {
"type": "string"
},
"project": {
"type": "string"
},
"thread": {
"type": "integer",
"description": "Thread id (from read_room)."
}
},
"required": [
"handle",
"project",
"thread"
]
}⚪live
Voice rooms with people in them right now and the rooms with messages in the last 48 hours. Voice presence comes from the running site (BYTELAND_URL, default http://127.0.0.1:8787); without it only the recent rooms are known.
输入模式
{
"type": "object",
"properties": {}
}⚪preview_building(handle, github, lang)
Builds a user's building as if it stood at the start of a street (GitHub repositories become rooms). The preview is not added to the city. Append the returned url_hash to index.html to open it on the site.
输入模式
{
"type": "object",
"properties": {
"handle": {
"type": "string"
},
"github": {
"type": "boolean",
"description": "Look up GitHub’s public data. Default: true."
},
"lang": {
"type": "string",
"enum": [
"en",
"tr",
"es",
"pt",
"fr",
"de",
"it",
"nl",
"pl",
"ru",
"uk",
"ar",
"hi",
"id",
"zh",
"ja",
"ko"
],
"description": "Language of text fields (recipe, badges, topic names). Default: en."
}
},
"required": [
"handle"
]
}社区
证据