RuneScape

mcp-server-runescape

Este é um servidor MCP com ferramentas para interagir com dados do RuneScape (RS) e Old School RuneScape (OSRS), incluindo preços de itens, hiscores de jogadores e muito mais.

https://github.com/user-attachments/assets/7c141575-443b-4b76-8b33-6d48ec82fbe7

Recursos

O servidor MCP fornece várias ferramentas usadas para responder suas perguntas durante o jogo com dados de fontes precisas.

1. Detalhes do Item (get_item_details)

Recupere informações abrangentes sobre itens negociáveis, incluindo:

• Preço atual na Grand Exchange
• Tendências de preço (24h, 30, 90 e 180 dias)
• Nome
• Categoria
• Descrição (texto de exame)
• Imagem
• Membros
• ID

https://runescape.wiki/w/Application_programming_interface#detail

2. Histórico de Preços do Item (get_item_price_history)

Acesse o histórico de preços de um item nos últimos 180 dias, incluindo:

• Preço em um determinado dia (timestamp)
• Preço médio em um determinado dia (timestamp)

https://runescape.wiki/w/Application_programming_interface#Graph

3. Hiscore do Jogador (get_player_hiscore)

Busque classificações e experiência para habilidades e atividades de qualquer jogador, incluindo:

• Classificação do jogador
• Nível de habilidade
• Pontos de experiência
• Pontuações de atividades

https://runescape.wiki/w/Application_programming_interface#Hiscores_Lite_2

4. Principais Classificações (get_top_rankings)

Veja os principais (máx. 50) jogadores para uma habilidade ou atividade específica, incluindo:

• Nome
• Pontuação (usada tanto para habilidades quanto para atividades)
• Classificação

https://runescape.wiki/w/Application_programming_interface#ranking

5. Contagem de Jogadores (get_player_count)

Obtém o número de jogadores atualmente online no RuneScape e Old School RuneScape, incluindo:

• Contagens de jogadores em tempo real

https://runescape.wiki/w/Application_programming_interface#player_count

6. Totais de Contas (get_rsuser_total)

Obtém a quantidade atual de contas criadas que podem acessar qualquer forma de RuneScape. Isso inclui contas feitas no FunOrb ou em uma versão específica do RuneScape, incluindo:

• Dados históricos de criação de contas

https://runescape.wiki/w/Application_programming_interface#rsusertotal

Nota

Por consistência, tentei usar apenas endpoints de API que suportam dados tanto de RS quanto de OSRS.

Exemplos de Uso

O objetivo é que você tenha uma maneira fácil de buscar dados mais precisos direto da fonte enquanto joga.

Aqui estão alguns exemplos de perguntas que você pode fazer à IA ao usar este servidor MCP:

Detalhes do Item

"What is the price of a dragon scimitar in the Grand Exchange?"
"Torva full helm price"
"Current price of a dragon pickaxe"
"How much percentage has the price of a dragon pickaxe changed in the past 30 days?"
"How much percentage has the price of a dragon pickaxe changed in the past 90 days?"
"How much percentage has the price of a dragon pickaxe changed in the past 180 days?"
"Give me the description of an armadyl godsword"
"Give me the icon of a dragon scimitar"
"What is the id of an abbyssal whip?"

Histórico de Preços do Item

"Give me the price history of a dragon scimitar"
"Rune scimitar price on 1 april 2025?"

Hiscore do Jogador

"What rank is Zezima?"
"What rank is Zezima on runescape?"
"How much experience does Lynx Titan have overall?"
"Iron Hyger ironman rank?"

Principais Classificações

"Top 10 players overall?"
"Give me the top 50 attack rankings"
"Number one agility on runescape?"
"Most zulrah kills?"
"Give me the top 5 jad rankings"

Começando

Introdução aos servidores MCP

Você pode usar o servidor MCP em muitos clientes, por exemplo:

• Claude desktop
• Cursor

1. Adicione o servidor MCP na sua configuração (Pacote NPM)

Cole este trecho na sua configuração mcp que seu cliente está usando

{
  "mcpServers": {
    "mcp-server-runescape": {
      "command": "npx",
      "args": ["-y", "mcp-server-runescape"]
    }
  }
}

Você pode encontrar o arquivo de configuração em (mac):

• Claude desktop:

~/Library/Application Support/Claude/claude_desktop_config.json

• Cursor:

/Users/name/.cursor/mcp.json

2. A partir do código-fonte

Requisito Node.js instalado no seu sistema

1. Clone este repositório
2. Instale as dependências:

   yarn
   

   ou

   npm install
   

3. Em seguida, atualize seu Claude desktop ou Cursor com:

   {
     "mcpServers": {
       "mcp-server-runescape": {
         "command": "node",
         "args": ["/Users/path/to/mcp-server-runescape/src/server.js"]
       }
     }
   }
   

4. Opcional: Execute o depurador/inspetor

   yarn dev
   

   ou

   npm run build
   

Certifique-se de:

• Substituir /path/to/mcp-server-runescape pelo caminho real da sua instalação.

Após atualizar a configuração, reinicie o Claude desktop ou o Cursor para que as alterações tenham efeito.

Preferência pessoal

Você pode usar qualquer cliente que quiser, minha preferência pessoal no momento é o Cursor em combinação com o deepseek-v3.1, que está tendo um desempenho muito bom.

Lista de clientes

Documentação da API

Para informações detalhadas sobre os endpoints da API do Runescape usados por este servidor MCP, visite: API RS/Wiki

Agradecimentos

Construí isso durante o fim de semana para aprender um pouco mais sobre servidores MCP. Runescape foi o assunto perfeito para testar.

• Agradecimento especial à equipe rs/wiki pela documentação e API.

Se isso ajudar você de alguma forma durante o jogo e quiser me apoiar, fique à vontade para